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Using This Book 


Purpose 

SAS/C Development System User’s Guide, Volume 1: Introduction, 
Editor, Compiler, Version 6.50 describes how to install and use your 
SAS/C Development System. This book describes the editor and 
compiler in detail and provides an overview of some of the major tools 
available to the SAS/C and C+ + programmer under AmigaDOS, such 
as the debugger, the message browser, and the scopts utility. 

“Using This Book” describes how you can best use this book. It 
describes the book’s intended audience, the audience’s prerequisite 
knowledge, the book’s organization and its conventions, and additional 
documentation that is available to you. 


Audience 

This book assumes you have a working knowledge of the C and C+ + 
languages and the AmigaDOS operating system. For a list of 
publications you can use to learn the C or C + + languages, or the 
AmigaDOS operating system, refer to the “Additional Documentation” 
section at the end of “Using This Book.” 


How to Use This Book 

This section gives an overview of the book’s organization and content. 
The book’s chapters are described, followed by a section on how to use 
each chapter. 

Organization SAS/C Development System User’s Guide, Volume 1: Introduction, 

Editor, Compiler is divided into four parts; the chapters and appendices 
contained in each part are described here: 

Part 1: Getting Started 

Part 1 contains three chapters that show you how to install the SAS/C 
Development System, use its major features, and get help when 
necessary. 

Chapter 1, “Installing Your SAS/C Development System” 

describes how to install the SAS/C Development System, assign 
logical device names, set environment variables, and upgrade from 
previous versions of the product. 
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Chapter 2, “Using Your SAS/C Development System" 

describes briefly how to use the major features of the SAS/C 
Development System: the editor, the compiler, the debugger, the 
scmsg utility, and the s copts utility. 

Chapter 3, “Getting Help" 

describes how to use the online help system and how to contact the 
Technical Support Division. 

Part 2: Using the Screen Editor (se) 

Part 2 contains four chapters that describe how to use the editor, how 
to customize the keymap, and how to use AREXX with the editor. 
Chapter 4, “Using se” 

describes the most frequently used s e commands and options. 
Chapter 5, “Controlling se” 

lists all of the options and commands available in se. 

Chapter 6, “Customizing the Editor” 

describes how to use the SE Configuration Window. The 
configuration window enables you to customize the meaning of 
various keystrokes within se. 

Chapter 7, “Using the AREXX Interface to se” 

describes how to use AREXX to create complicated macros and to 
communicate with other programs from se. 

Part 3: Using the Compiler and Linker 

Part 3 contains six chapters that describe how to compile, link, and 
run your program. These chapters also provide guidelines for writing 
your application. 

Chapter 8, “Compiling and Linking Your Program” 
describes how to use the compiler and linker. 

Chapter 9, “Running Your Program from the Workbench Screen” 
describes special considerations for running your program from the 
Workbench screen. 

Chapter 10, “Using Startup Modules, Autoinitialization, and 
Autotermination Functions” 

describes what functions the startup modules perform and how to 
write your own autoinitialization and autotermination functions. 
Chapter 11, “Using SAS/C Extensions to the C and C++ Languages” 
describes how to use SAS/C extensions to the C and C+ + 
languages. 
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Chapter 12, “How the Compiler Works” 

describes briefly how the C+ + translator translates your C+ + 
program into a C program and what happens when you compile, 
link, and run a C program. This chapter also describes the format 
of the object files produced by the compiler. 

Chapter 13, “Writing Portable C Code” 

provides guidelines for improving the portability of your program. 

Part 4: Appendices 

Part 4 contains five appendices. 

Appendix 1, “Solving Common Problems” 

contains answers to the questions that users ask most frequently 
when they call the Technical Support Division. 

Appendix 2, “Error and Warning Messages” 

contains explanations for the diagnostic messages produced by the 
compiler and linker. 

Appendix 3, “Implementation-Defined Behavior” 

describes how the SAS/C Compiler behaves for each of those areas 
where the ANSI Standard allows an implementation to define its 
own behavior. 

Appendix 4, “Converting From Aztec C to the SAS/C Development 

System” 

describes four utilities that help you convert from Aztec C to SAS/C 
and contains two tables that list each of the Version 5 Aztec C 
compiler and linker options and their equivalent Version 6 SAS/C 
options. 

Appendix 5, “Converting from Version 5 to Version 6” 

provides guidelines for converting your projects to Version 6 SAS/C 
software. This appendix also lists each of the Version 5.10 options 
and their equivalent Version 6 options. 
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What You 
Should Read 


Typographical 

Conventions 


The following table points you to specific chapters in this book for 
information on particular topics. For other references, refer to 
“Additional Documentation" later in this section. 


For information on 

You should read 

installing the product 

Chapter 1 

upgrading from previous versions of the product 

Chapter 1 and 
Appendix 5 

using the major features of the SAS/C 
Development System 

Chapter 2 

contacting the Technical Support Division 

Chapter 3 

using online help 

Chapter 3 

using the editor 

Chapters 4 and 5 

specifying the s c command and compiler options 

Chapter 8 

managing the environment in which your program 
runs 

Chapters 9 and 
10 

using extensions to C+ + and ANSI C 

Chapter 11 


Conventions 

This section covers the typographical and syntax conventions used in 
this book. 

The SAS/C books for AmigaDOS use special fonts to depict specific 
types of information. These typographical conventions are as follows: 
roman is the basic type style used for most text, 
monospace is used to show example statements or programs. 

Monospace is used also for items specific to the 
C and C+ + languages, such as the names of functions, 
header files, and keywords. To distinguish between C 
and C+ + function names, the names of C+ + 
functions are followed by parentheses, as in setf { ) . 
obi i que is used for argument, variable, or parameter values 
when they are shown as displayed by the SAS/C 
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Development System. For example, a compiler message 
may contain a character string from your program. 
italic is used for terms that are defined and for arguments or 
variables whose values are supplied by the user. For 
example, you should enter an appropriate filename 
when you see filename. 


Syntax 

Conventions 


This book uses the following conventions for syntax: 


monospace 


italic 
[] (square 
brackets) 
. (ellipsis) 


indicates commands, keywords, and switches that 
should be spelled exactly as shown. These 
arguments may or may not be optional, depending 
on whether they are enclosed in square brackets, 
indicates arguments for which you supply a value, 
indicate an optional argument when they surround 
the argument. 

indicates that you can repeat the argument or 
group of arguments preceding the ellipsis any 
number of times. 


(vertical bar) 


means to choose one item from a group of items 
separated by the bars. 


The following example illustrates these syntax conventions: 


env [function | integer] 


env 

is a command name, so it appears in monospace type. 
function 

is a function for which you supply the name, so it appears in italic 
type. 

[function | integer) 

are both optional, so they are enclosed in square brackets. 
function \ integer 

indicates that you can specify only one of the items separated by the 
vertical bar. 


Additional Documentation 

The following sections list documentation you may find helpful in using 
the SAS/C Development System. 
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SAS 

Documentation 


If you are interested in SAS documentation, you need to contact the 
Book Sales department by writing to the following address or by 
calling the following number: 


SAS Institute Inc 
Book Sales Department 
SAS Campus Drive 
Cary, NC 27513 
Telephone: 919-677-8000 
Fax: 919-677-8166 


SAS/C Development System 

This book is part of a set of publications for the SAS/C Development 
System. There are three other publications in the set: 

□ SAS/C Development System User’s Guide, Volume 2: Debugger, 
Utilities, Assembler, Version 6.50 describes how to use 

□ CodeProbe, the SAS/C Source Level Debugger 

□ the utilities such as smake, grep, scopts, and scmsg 

□ the SAS/C Macro Assembler 

□ the global optimizer, peephole optimizer, and instruction 
scheduler. 

□ SAS/C Development System Library Reference, Version 6.50 describes 
how to 

□ access libraries 

□ create your own libraries 

□ use header files to reduce the amount of time and space required 
by your program. 

□ SAS/C Development System Quick Reference, Version 6.0 contains 
reference tables for the library functions, compiler and linker 
options, and debugger commands. 

These volumes are sold together as a set with the software. 

Other The following sections list additional reference material specific to the 
Documentation C language, Amiga and AmigaDOS programming, and the Motorola 
68xxx microprocessor family. 

C Language 

The following books describe the C programming language: 

American National Standards Committee (1990), American National 
Standard for Information Systems — Programming Language C, 
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Document Number X3J1 1/90-013, Washington, D.C.: X3 
Secretariat: Computer and Business Equipment Manufacturers 
Association. 

Harbison, Samuel P. and Steele, Guy L., Jr. (1990), C: A Reference 
Manual, Third Edition, Englewood Cliffs, NJ: Prentice-Hall, Inc. 

Kernighan, Brian W. and Ritchie, Dennis M. (1988), The C 
Programming Language, Second Edition, Englewood Cliffs, NJ: 
Prentice-Hall, Inc. 

Kochan, Stephen G. (1988), Programming in ANSI C, First Edition, 
Indianapolis, Indiana: Hayden Books. 

C+ + Language 

The following books describe the C+ + programming language: 

Ellis, Margaret A. and Stroustrup, Bjame. (1990), The Annotated 
C+ +- Reference Manual, Reading, MA: Addison-Wesley Publishing 
Company. 

Ranade, Jay and Saba, Zamir. (1992), C+ + Primer For C 
Programmers, New York, NY: McGraw-Hill, Inc. 

Sessions, Roger. (1992), Class Construction in C and C++: object- 
oriented programming fundamentals, Englewood Cliffs, NJ: Prentice- 
Hall, Inc. 

Stroustrup, Bjarne. (1991), The C+ + Programming Language, Second 
Edition, Reading, MA: Addison-Wesley Publishing Company. 

Amiga and AmigaDOS 

The following books provide information specifically about 

programming on the Amiga system. Most of the examples in these 

books are written in C or assembly language. 

Commodore-Amiga, Inc. (1990), Using the System Software, Reading, 
MA: Addison-Wesley Publishing Company. 

Commodore-Amiga, Inc. (1991), Amiga Hardware Reference Manual, 
3rd Edition, Reading, MA: Addison-Wesley Publishing Company. 

Commodore-Amiga, Inc. (1991), Amiga ROM Kernel Reference Manual: 
Devices, 3rd Edition, Reading, MA: Addison-Wesley Publishing 
Company. 

Commodore-Amiga, Inc. (1991), Amiga ROM Kernel Reference Manual: 
Includes and Autodocs, 3rd Edition, Reading, MA: Addison-Wesley 
Publishing Company. 

Commodore-Amiga, Inc. (1991), Amiga User Interface Style Guide, 
Reading, MA: Addison-Wesley Publishing Company. 

Commodore-Amiga, Inc. (1991), The AmigaDOS Manual, 3rd Edition, 
New York, NY: Bantam Books. 
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Motorola 68xxx 


Contacting 

CATS 


Commodore-Amiga, Inc. (1992), Amiga ROM Kernel Reference Manual: 
Libraries, 3rd Edition, Reading, MA: Addison-Wesley Publishing 
Company. 

The following books contain information specifically about 

programming the Motorola 68xxx family of microprocessors. 

Motorola, Inc. (1987), MC68881/MC68882 Floating-Point Coprocessor 
User’s Manual, First Edition, Englewood Cliffs, NJ: Prentice-Hall, 

Inc. 

Motorola, Inc. (1989), MC68030 Enhanced 32-Bit Microprocessor 
User’s Manual, Second Edition, Englewood Cliffs, NJ: Prentice-Hall, 
Inc. 

Motorola, Inc. (1989), Programmer’s Reference Manual, Phoenix, AZ: 
Motorola Literature Distribution. 

You can contact Commodore Application and Technical Support at the 

following address: 


Commodore Business Machines, Inc. 
Department C 
1200 Wilson Drive 
West Chester, PA 19380 


215-431-9180 
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Changes and Enhancements for Version 6.0 

The following sections describe some of the changes and enhancements 

for the SAS/C Development System, Version 6.0. 

□ The SAS/C Development System has an extensive online help system 
implemented using the AmigaGuide hypertext system from 
Commodore. The online help describes each utility, CodeProbe 
command, editor command, library function, diagnostic message, and 
compiler option. For a complete description of using the help system, 
see Chapter 3, “Getting Help.” 

□ The SAS Institute Technical Support Division has a facility called 
EMITS (Electronic Mail Interface to Technical Support) that allows you 
to report problems and receive help through Internet. For more 
information, see Chapter 3, “Getting Help.” 

□ Compiler executables and other files are installed in a directory tree 
pointed to by the assign sc:. Unlike the Version 5 assign lc : , sc : 
points to the root of the compiler’s installation directory. 

□ The lc compiler front-end has been replaced with the new sc front- 
end, which takes options in a different form. The new sc front-end 
accepts C source files, assembly language files, object files, and 
libraries. You may specify options before or after the filenames. See 
Chapter 8, “Compiling and Linking Your Program,” for more 
information. 

To help you make the transition to Version 6, the SAS/C 
Development System provides two utilities, sc 5 and lctosc. The sc 5 
command accepts options in the form accepted by lc and invokes the 
Version 6 compiler. The lctosc utility accepts options in the form 
accepted by lc and prints the equivalent sc options to stdout. Both 
sc5 and lctosc read the sascopts file, if present. Appendix 5, 
“Converting from Version 5 to Version 6,” provides guidelines for 
converting your projects to Version 6. 
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□ The names of various other executables have changed. The following 
table lists the names of the Version 5 executables and the 
corresponding Version 6 names. 


Version 5 Version 6 

blink slink 

lse se 

sascoptions scopts 

sascsetup scsetup 


□ Many symbols and functions in the link libraries have new names that 
adhere to the ANSI Standard. The Standard requires that all non-ANSI 
symbols referenced in ANSI header files start with two underscores or 
an underscore and a capital letter. The Version 5 symbols that violated 
this standard have been renamed, usually by adding one or two 
underscores to the front of the name. For information on a specific 
symbol, refer to Chapter 6, “Predefined Data Name Reference,” in 
SAS/C Development System Library Reference. 

□ The name of the file that is created by the scopts utility has been 
changed from sascopts to scoptions. 

□ The AmigaDOS 1.3 header files are no longer shipped with the SAS/C 
Compiler. However, all AmigaDOS 1.3 functions are available under 
higher versions of AmigaDOS, so you can develop code that runs under 
AmigaDOS 1.3 by restricting your program from using any AmigaDOS 
2.0 or above functions. 

□ The SAS/C Development System, Version 6, does not have separate 
libraries for use with registerized parameters. The normal link libraries 
have both registerized and nonregisterized entry points. If you write a 
function that has the same name as a library function, you need to 
make sure that all calls to the function are using your version. For 
more information, see “Replacing Library Functions With Your Own 
Functions” in Chapter 5, “Advanced Library Techniques,” in SAS/C 
Development System Library Reference. 

□ The Id, lc2, and go commands are not included in Version 6 of the 
SAS/C Development System. The sc driver loads AmigaDOS shared 
libraries to handle the work of the various phases instead of invoking 
multiple programs. 



Changes and Enhancements 


□ The lseinst program has been removed, and the se configuration 
window added in its place. Select the Configuration Window option 
from the Options pull-down menu in se to invoke the configuration 
window. For complete description of using the configuration window, 
see Chapter 6, "Customizing the Editor.” 

□ The precompiled header files in Version 5 have been replaced with 
GSTs (Global Symbol Tables). GSTs are much faster than precompiled 
headers because they remain in RAM between compiles. Some 
additional utilities, gst and hypergst, allow you to browse the 
RAM-resident GST files for information on symbols defined in system 
header files or in your header files. For information on creating and 
using GSTs refer to SAS/C Development System Library Reference and 
to the descriptions of the gst and hypergst utilities in SAS/C 
Development System User’s Guide, Volume 2: Debugger, Utilities, 
Assembler. See also the descriptions of the gst and makegst 
compiler options in Chapter 8, "Compiling and Linking Your 
Program.” 

□ The new scrasg utility enables you to integrate any editor that 
supports AREXX into the SAS/C Development System. For more 
information, see the description of the errorrexx compiler option in 
Chapter 8, “Compiling and Linking Your Program," and the description 
of the scmsg utility in SAS/C Development System User’s Guide, 

Volume 2. 

□ The global optimizer supports many new optimizations, including inline 

functions. You can use the inline keyword to specify a function 

that is to be inlined. See Chapter 11, “Using SAS/C Extensions to the C 
and C++ Languages,” for information on special keywords supported 
by the SAS/C Compiler. Refer to SAS/C Development System User’s 
Guide, Volume 2 for information on the global optimizer. 

□ The new peephole optimizer improves code quality significantly. The 
peephole optimizer is run automatically when you choose the 
optimize compiler option, unless you specifically suppress it with 
nooptpeep. Refer to SAS/C Development System User’s Guide, 

Volume 2 for information on the peephole optimizer. 
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□ The CodeProbe debugger has numerous enhancements. The major 
enhancements include the following: 

a The command syntax has been totally rewritten and greatly 
extended. 

□ The debugger has new support for debugging AmigaDOS shared 
libraries. 

□ The debugger automatically detects Enforcer hits caused by your 
program and halts your program at the location of the hit. 

□ The debugger now has cross-debugging capability. This new feature 
allows you to run your program on one machine and debug the 
program using another machine connected through the serial port 
or a network file system. 

Refer to SAS/C Development System User’s Guide, Volume 2 for a 
complete description of using the debugger. 

□ The compiler still generates code by default to check for stack overflow 
at the entry to each function. However, this code is more reliable 
under Version 6. 

The compiler also supports a new option that generates code to 
allocate a new stack and allow your program to continue running if the 
old stack runs out. For more information, see the description of the 
stackextend compiler option in Chapter 8, “Compiling and Linking 

Your Program.” See also the description of the stackextend 

keyword in “Managing Stack Space” in Chapter 11, “Using SAS/C 
Extensions to the C and C+ + Language.” 

□ The compiler now supports the relaxed reference-definition model for 
external data as well as the strict reference-definition model. For more 
information, see Chapter 11, “Using SAS/C Extensions to the C and 
C++ Languages.” 

a The compiler now supports a coverage option that generates special 
code that tells you which portions of your program were executed by 
your test cases. A new utility, the cover utility, analyzes the data 
produced by the compiler when you specify coverage. This 
information helps you design test cases that test all portions of your 
code. For more information, see the description of the coverage 
compiler option in Chapter 8, “Compiling and Linking Your Program,” 
and the description of the cover utility in SAS/C Development System 
User’s Guide, Volume 2. 

□ The stringmerge compiler option, equivalent to the -cs in 
Version 5, merges all string constants and places them in the code 
section. Unlike the Version 5 option, stringmerge also places all 
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data declared static const and all automatic initializer data in the 
code section. For more information, see the description of the 
stringmerge compiler option in Chapter 8, “Compiling and Linking 
Your Program.” 

□ The compiler can now produce a disassembly of the generated object 
code. For more information, see the description of the disassem 
compiler option in Chapter 8, “Compiling and Linking Your Program.” 

□ The compiler now adjusts dynamically to low-memory situations. If you 
compile your program and your machine runs low on memory, the 
compiler displays the message ***Freeing Resources and frees 
memory to enable it to continue the compilation. You can also use the 
memorysize compiler option to limit the compiler’s memory use. For 
more information, see the description of the memorysize option in 
Chapter 8, “Compiling and Linking Your Program.” 

□ You can designate autoinitialization functions that you want the 
compiler to call automatically before it calls your main routine. You 
can also designate autotermination functions that you want the 
compiler to call after main returns. For more information, see 
Chapter 10, “Using Startup Modules, Autoinitialization, and 
Autotermination Functions.” 

□ System library bases that are not defined in your code are 
automatically opened and initialized. For more information, see 
Chapter 10, “Using Startup Modules, Autoinitialization, and 
Autotermination Functions.” 

□ The SAS/C Compiler now permits references to unnamed unions and 
direct references to members of substructures. The compiler also 
permits zero-length arrays as members of structures. For more 
information, see Chapter 11, “Using SAS/C Extensions to the C and 
C+ + Languages.” 

□ The new flpragma tagcall allows you to call AmigaDOS functions 
that take a variable parameter list without using assembler stubs. For 
more information, refer to SAS/C Development System Library 
Reference. 

□ The new #pragma msg allows you to control compiler diagnostic 
output more closely. For more information, see Chapter 11, “Using 
SAS/C Extensions to the C and C+ + Languages.” 

□ The compiler now supports char, short, and long enum types. For 
more information, see Chapter 11, “Using SAS/C Extensions to the C 
and C+ + Languages.” 
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□ The format of bitfields has changed in Version 6. If you have a 
program that ran under Version 5.10 or earlier that depends on the 
order of bitfields, your program must be modified to run under 
Version 6. 

a Unlike previous versions of the compiler, the interrupt keyword 

does not imply that the function will be called with stack arguments. If 
you compile with the parameters = register option, add the 

stdargs keyword to the definition and prototype for any function 

that must receive its parameters on the stack. 
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Changes and Enhancements for Version 
6.50 

The following sections describe some of the changes and enhancements 

for the SAS/C Development System, Version 6.50. 

□ The SAS/C Development System now supports translation of C+ + 
files. This version of the C+ + translator is compatible with CFRONT 
Version 2.1 from AT&T. The sc front-end now accepts C++ files. See 
Chapter 8, “Compiling and Linking Your Program," for more 
information. 

□ The SAS/C Development System provides two C+ + libraries: the 
streams library and the complex library. The streams library defines 
classes and functions that allow you to perform input, output, and 
string formatting. The complex library defines a class containing 
functions and operators that allow you to manipulate complex 
numbers. Refer to Chapter 8, “C+ + Library Reference," in SAS/C 
Development System Library Reference, for a more information. 

□ The new demangle utility converts C names that were generated by 
the C+ + translator into their original C+ + forms. For more 
information, refer to the description of the demangle utility in SAS/C 
Development System User’s Guide, Volume 2: Debugger, Utilities, 
Assembler. 

□ The 68040/68882 Instruction Scheduler changes the order of 
instructions to create code that runs faster on the 68040 CPU and 
68882 math coprocessor. Refer to SAS/C Development System User’s 
Guide, Volume 2 for information on the instruction scheduler. 

□ The peephole optimizer optimizes more patterns of assembler 
instructions. 

□ The compiler now generates more efficient stack extension code when 
you use the stackextend option. 

□ The compiler generates more efficient code when your program returns 
structures. Code that returns structures must be recompiled with 
Version 6.50 if it is to continue to work. 
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□ CodeProbe has many additional enhancements in Version 6.50. The 
major enhancements include support for: 

□ debugging C+ + files. CodeProbe can display data items that are 
members of classes and set breakpoints on overloaded C+ + 
functions, member functions, operators, constructors, and 
destructors. The correct C+ + source code is displayed at all times, 
in both regular and mixed mode. 

□ debugging functions defined in header files. 

□ setting tab stops, instead of forcing tab stops every eighth column. 

□ debugging devices. CodeProbe now allows you to set breakpoints in 
devices like Version 6.0 allowed in shared libraries. 

□ the segtracker utility. CodeProbe works with segtracker 
(which is provided with the SAS/C Development System) to find 
SegLists for new tasks caught by the debugger. 

In addition, debugging multitasking programs has been simplified. 

Refer to SAS/C Development System User’s Guide, Volume 2 for a 
complete description of using the debugger. 

□ The SAS/C Macro Assembler now supports placing sections in chip 
memory by specifying the chip option in the SECTION directive. 

□ The global optimizer and the compiler now send all messages to 
scmsg instead of sending them to the console. 

□ The compiler supports a new option, stringsection, that allows 
you to place string constants and data declared as static const in 
your choice of the near, far, or code sections, independent of string 
merging. See Chapter 8, “Compiling and Linking Your Program,” for 
more information. 

□ Under AmigaDOS 2.0 and later, se, CodeProbe, and the scopts and 
scmsg utilities now support the System Default font that you select 
with the Preferences Font Editor. 


□ se supports the AREXX command KD, which allows you to load a key 
definition file. For more information on using AREXX, see Chapter 7, 
“Using the AREXX Interface to se.” 


□ The new sprof utility works with the new profile compiler option 
to tell you how much time your program spends executing each 


function and how many times each function was called. For more 


information, refer to the description of the sprof utility in SAS/C 


Development System User’s Guide, Volume 2: Debugger, Utilities, 


Assembler. 
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□ The new sraf ind utility helps you find and change character strings in 
your source code, smf ind uses the grep utility to locate the character 
string you specify in the files that you specify, and it displays each 
occurrence of the character string using the message browser (scrasg). 
For more information, refer to the description of the smf ind utility in 
SAS/C Development System User’s Guide, Volume 2: Debugger, Utilities, 
Assembler. 

□ The standard shared library startup module libinitr.o now calls 
autoinitialization and autotermination functions when your program 
calls OpenLibrary and CloseLibrary. For more information, see 
Chapter 10, “Using Startup Modules, Autoinitialization, and 
Autotermination Functions.” 

□ New startup modules support automatic building of devices, as well as 
libraries. 

□ The compiler now supports all library functions in shared libraries 

except abort, exit, and exit. You also cannot use setjmp and 

longjmp to jump across a call from the program into the library. The 
compiler supports printf and the other standard I/O functions in 
shared libraries. 

□ The sc command supports several options, such as libfd and 
librevision that allow you to create shared libraries without 
calling the linker directly. See Chapter 8, “Compiling and Linking Your 
Program,” for more information. 

□ The use of the stdio and nostdio options and the tinymain 

routine is obsolete. The linker now automatically determines if your 
program uses standard I/O, and if so, stdin, stdout, and stderr 
are automatically initialized. If your program does not use standard 
I/O, they are not initialized, and you do not have to specify any special 
options. 

a You can now determine the order that autoinitialization and 

autotermination functions are run. For more information, see Chapter 
10, “Using Startup Modules, Autoinitialization, and Autotermination 
Functions.” 
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□ To help you make the transition from Aztec C, the SAS/C Development 
System now supports the following: 

□ #pragma regcall, which is used for calls to functions defined in 
your own code. This pragma tells the compiler to pass parameters 
in specific registers, as if you had declared the function with the 
asm keyword. 

□ ((pragma amicall, which allows you to call any library routine. 

□ the new library functions dos_packet, mktemp, mkstemp, 
scdir, and several screen control functions such scr_beep and 
scr_cinsert. 

□ the cctosc utility, which converts Aztec C compiler options to 
SAS/C compiler options. 

□ the mcc command, which accepts cc options and runs the SAS/C 
compiler, mcc is an Aztec C compatible driver for sc. You can 
specify Aztec C and SAS/C options. 

□ the lntoslink utility, which converts Aztec C linker options to . 
SAS/C linker options. 

D min command accepts In options and runs the SAS/C linker, min 
is an Aztec C compatible driver for slink. You can specify Aztec C 
and SAS/C options. 

For more information about the ((pragma statements and library 
functions, refer to SAS/C Development System Library Reference. For 
more information about the utilities and commands, see Appendix 4, 
“Converting From Aztec C to the SAS/C Development System.” 
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Introduction 

This chapter describes how to install your SAS/C Development System 
and provides guidelines for upgrading your projects to Version 6. 


Protecting Your Investment 

Before you install your SAS/C Development System, you should do the 

following: 

□ Make backup copies of the disks distributed with this product. To make 
copies, you can use the AmigaDOS diskcopy command, or you can 
select the disk icon and choose copy from the Icons menu. Refer to 
your AmigaDOS manual for more information on copying disks. 

□ Write down your registration number where you can find it easily. You 
must give your registration number to the Technical Support staff 
before you can receive help from the SAS Institute Technical Support 
Division. 

a If your product came with a registration card, complete the registration 
card and return it to SAS Institute Inc. If you are a new user, you 
must register your purchase to qualify for technical support and to be 
notified about future upgrades. If you are upgrading from a previous 
version, your product should not contain a new registration card. You 
have already registered the previous version, so you do not need to 
send in a new registration card. If you have any questions about the 
status of your registration, contact the Book Sales Department at 919- 
677-8000. 



Installing the Product on A Hard Disk 

The installation program is distributed on disk number 1. You should run 
the installation program from the Workbench screen, not the Shell. 

If you are upgrading from a previous version, you should install 
Version 6.50 in a separate location from previous versions of the 
compiler. 

To install the SAS/C Development System, insert disk number 1 in the 
disk drive and double-click on the disk icon to open the 
SASC_6.50_Disk_l window. Double-click on the Install-SASC icon 
to open the Install-SASC window. 

If you want to see exactly what the installation program will do before 
you actually install the product, you can select the Pretend to Install and 
Log File options, and then proceed through the installation process. As 
you go through the installation process, the installation program writes to 
a log file all of the commands it would have executed if you were actually 
installing the product. The log file is named install_log_f ile and is 
written to the directory in which you are installing the product (or to 
ram: , if it cannot write to that directory). 

As you go through the installation process, the installation program 
asks you some questions, including the name of the directory, or 
destination, where you want to install the SAS/C Development System. 
The installation program allows you to save disk space by asking you 
which parts of the product you want to install. For example, you may 
choose not to install the cross debugger. If you choose not to install parts 
of the product, include this information in any communication you have 
with the Technical Support Division. 

After you have answered all of the questions (and if you select Install 
for Real), the installation program then proceeds to install the product. 
The program prompts you to insert disks as necessary. 

Context-sensitive online help is available at any point in the installation 
process by clicking on the Help button, and you can abort the 
installation process at any time by clicking on the Abort button. 

After all the files on the distribution disks have been copied to your 
hard disk, the installation program asks you if you want the following 
statements added to your s : user-startup file. 

assign sc: destination: sc 
assign lib: sc:lib 
assign include: sc:include 
assign cxxinclude: sc:cxxinclude 
path sc:c add 

The installation program adds these statements automatically if you select 
Proceed. If you decide to add these statements manually and do not 
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select Proceed, make sure you add them before any line that calls a 
utility that creates a new Shell, such as PopCLI. 

Finally, the installation program displays the re ad. me file. 

Note: Read the re ad. me file carefully. This file contains important 
information that is not contained in the documentation distributed with 
the product. This information may concern new or enhanced features, 
bug fixes, or changes to the documentation. The read .me file is installed 
in the sc: directory with the rest of the product, so you can refer to this 
file later. 

Modifying Your If you are running AmigaDOS 2.0 or later, the modifications that the 
Startup File installation program makes to your startup file (if you selected Proceed) 
are sufficient to allow the compiler to run. 

If you are running AmigaDOS 1.3, you may need to make an additional 
change to your s : startup-sequence file to make sure that these 
assign and path statements take effect. 

The installation program adds the path and assign statements to the 
file s : user-startup. The installation also asks you where to add the 
following lines: 

if exists s:user-startup 
execute s:user-startup 
endif 

The installation program suggests a place to enter these lines, but you can 
specify a different place if necessary. Make sure that these lines are 
entered before any line that calls a utility that creates a new Shell, such 
as PopCLI. The installation program adds these lines to either 
s : startup-sequence or s:startupll. 

If the lines are added to s : startupll, you must verify that 
s : startupll is properly executed from s : startup-sequence. 
Under some older versions of AmigaDOS Version 1.3, s : startupll is 
executed from s : startup-sequence through either a newshell 
command or a run execute command. Therefore, any path 
statements added to the s:user-startup file do not have any effect on 
the Workbench path. Edit your s : startup-sequence file, and verify 
that s : startupll is executed with an execute command only. If not, 
change the command to the following: 

execute s: startupll 

If this command is not in your s : startup-sequence file, add it. If 
s : startupll is executed with a run execute command, delete the 
word run. 
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After you have saved your s : startup-sequence file with the 
correct command and completed the installation process, re-boot your 
machine. Your compiler should work correctly. 


What Directories 
Does the 
Installation 
Program Create? 


After you finish installing the product, you will have a directory named 
sc that contains several files and subdirectories. The following list 
describes the directories that have icons. 

Note: Some of these icons may not be present if you choose not to 
install the entire package. 


□ starter_project is the directory that the scsetup utility uses as 
a model whenever you set up a project. (A project consists of all of the 
files that make up an application.) You can add icons and programs to 
starter_pro ject as necessary. For example, you can create an 
scoptions file in this directory that contains any compiler options 
that you want to be copied into each of your project directories, 
scsetup copies the entire contents of starter_pro ject into the 
project drawer you specify. The installation program places the 
following icons (and files) in this drawer: 


Edit 

Build 

Debug 

Find 

SCoptions 


invokes the se editor 
builds the project 
runs the debugger 
runs the smf ind utility 
sets compiler options. 


□ c contains the executable modules for the SAS/C Development System, 
including the assembler, compiler, debugger, linker, and various 
utilities. 

□ icons is a directory used by scsetup, se, and other utilities that 
contains default icons for different file types. You can replace any of 
the icons in this directory or add your own icons. For more 
information on using icons, see Chapter 2, “Using Your SAS/C 
Development System.” 

□ examples contains example programs. For each example, this 
directory contains complete source code and a read. me file that 
explains the example program and describes how to run the example. 
Some of the examples are in their own subdirectory under the 
examples directory. 

□ help contains help files used by the various SAS/C utilities. 

Chapter 3, “Getting Help,” describes the contents of this directory and 
how to use the help system. 

□ extras contains utility programs that may be useful or instructional. 
Browse the contents of this directory to see what is available. 
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The installation program also creates some directories that do not have 

icons. These directories are as follows: 

□ env contains default configuration information for tools such as the 
editor. The tools look first in env : sc for their configuration files, and 
if the files are not there, the tool looks in sc: env. 

□ source contains C and assembly language source code for various 
parts of the SAS/C Development System. For example, this directory 
includes the source code to the different startup modules. 

□ include contains C header files and assembler header files. The 
INCLUDE : logical device name should point to this directory. 

□ cxxinclude contains C+ + header files. The CXXINCLUDE: logical 
device should point to this directory. 

□ Lib contains link libraries. The LIB: assign should point to this 
directory. 

□ libs contains resident libraries used by the various SAS/C commands. 
These libraries must exist in the sc : libs drawer. Do not attempt to 
copy them into libs : with the AmigaDOS system libraries. The 
following libraries are included in this drawer: 

sc 1 . library 

is required by the compiler. This library must be present to 
compile any code. 
sc2 .library 

is required by the compiler. This library must be present to 
compile any code, 
sccxx . library 

is required to compile any C+ + files, 
scgo . library 

is required by the global optimizer. This library must be present if 
you compile with the optimize option and do not specify the 
nooptglobal option, 
scpeep . library 

is required by the peephole optimizer and instruction scheduler. 
This library must be present if you compile with the optimize 
option and do not specify the nooptpeep option, 
scdebug. library 

generates debugging information. Without this library, the 
compiler can generate partial line number information but cannot 
generate any symbolic debugging information, 
scgst. library 

generates or accesses GSTs (Global Symbol Tables). This library is 
not required if you never use the GSTs. Refer to SAS/C 



Development System Library Reference for information on using 
GSTs. 

schi . library 

is used by CodeProbe to read the debugging information in an 
executable module. This library is required if you run the 
debugger. 

sekeymap . library 

is used by the editor to allow you to modify the editor’s 
configuration, 
scspill . library 

detects low-memory conditions and attempts to reduce the 
compiler’s memory usage. This library is required if you want the 
compiler to react dynamically to low-memory conditions. 

If you compile your program and your machine runs low on 
memory, the compiler displays the message ♦•♦Freeing 
Resources and frees memory to enable it to continue the 
compilation. You can force the compiler to free memory at any 
time by pressing Control-F in the window to which the compiler 
is sending output, 
sclist .library 

generates listing and cross-reference files. This library is not 
required if you never use the list or xref compiler options. 

It is recommended that you do not place your source code in the sc 
directory tree. Installing updates to the SAS/C Development System is 
easier if you can replace the entire directory without worrying about 
losing any of your own program files. Instead, you should set up a 
different directory for your C development work. You may find it useful 
to keep different projects in different directories. Keeping projects 
separated makes it easier to keep track of the makefiles and compiler 
options required for each project. Remember, a project consists of all of 
the files that make up an application. 

Note: If you choose to both install Version 6.50 and keep Version 6.0 
installed, you must reboot or execute the avail flush command each 
time that you change the directory to which sc: points. 


Installing the Product on Floppy Disks 

The installation program is distributed on disk number 1. You should run 
the installation program from the Workbench screen, not the Shell. 

Before installing the SAS/C Development System, make sure you have 
three blank disks on which to install this product. 
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To install the SAS/C Development System, insert disk number 1 in the 
drive df 0 : and double-click the disk icon to open the 
SASC_6.50_Disk_l window. Double-click the Install-SASC icon to 
open the Install-SASC window. 

If you want to see exactly what the installation program will do before 
you actually install the product, you can select the Pretend to Install and 
Log File options, and then proceed through the installation process. As 
you go through the installation process, the installation program writes to 
a log file all of the commands it would have executed if you were actually 
installing the product. The log file is named install_log_f ile and is 
written to ram:. 

As you go through the installation process, the installation program 
asks you some questions, then proceeds to install the product. The 
program prompts you to insert disks as necessary. 

Note: You cannot run C+ + from a floppy-only system. Also, the 
cross debugger and math libraries other than s cm. lib are not available 
with C. 

The installation program produces the following three working disks: 
Disk 1 contains the setup program, the compiler (sc), linker (slink), 
and editor (se), and the smake, scopts, scmsg, and oml 
utilities. This disk is not a bootable disk. You must boot the 
machine using your own disk. 

Disk 2 contains compressed header files (including header files for 

Commodore shared libraries), startup modules, the sc . lib and 
s cm. lib link libraries, and a small version of amiga . lib 
containing only global symbols (no stubs). 

Disk 3 contains CodeProbe, the global and peephole optimizers, the 
instruction scheduler, and the omd utility. 

Caution Do not move files from one disk to another. 

If you move files around, the SAS/C Development System will not 
function properly. A 

Online help is available at any point in the installation process, and you 
can abort the installation process at any time. 

Finally, the installation program displays the read. me file. 

Note: Whenever you boot your machine, you must run the setup 
file on Disk 1 before running SAS/C. The setup file issues assign 
statements and adds s c : c to your path. 

Note: Read the re ad. me file carefully. This file contains important 
information that is not contained in the documentation distributed with 
the product. This information may concern new or enhanced features, 
bug fixes, or changes to the documentation. 



Assigning Logical Device Names 

When you install the SAS/C Development System on a hard drive, the 
installation program tells you that specific assign statements must be 
added to your startup file. You may choose to allow the installation 
program to add these statements for you. 

When you install the SAS/C Development System on floppy disks, you 
must run the setup file on Disk 1 each time you boot your machine, 
before you run SAS/C. This setup file issues the assign statements 
required to run the SAS/C Development System. 

The following list describes each of the logical device names that are 
required to run the SAS/C Development System. 

sc : 

specifies the directory in which the compiler and other utility 
programs are located. For example, the following statement indicates 
that the compiler and utilities are in the directory work : sc. 

assign sc: work:sc 

include : 

specifies the directory in which the compiler can find system header 
files included in your programs by specifying the # include statement 
with angle brackets (<>). For example, you could enter the following 
assign statement from the Shell prompt: 

assign include: dfO: sc/include 

Then, if you compile a program containing the statement # include 
<stdio.h>, the compiler attempts to include the file df 0 : sc/ 
include/stdio.h. If you include a header file from the include: 
directory in your C+ + program, the compiler treats that header file 
as if it is enclosed in 

extern "C" ( 

/* header file */ 

) 


cxxinclude : 

specifies the directory in which the compiler can find C+ + system 
header files included in your programs by specifying the # include 
statement with angle brackets (<>). For example, you could enter the 
following assign statement from the Shell prompt: 
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assign cxxinclude: dhl :sc/cxxinclude 

Then, if you compile a C + + program containing the statement 
((include <iostream. h>, the compiler attempts to include the file 
dhl : sc/cxxinclude/iostream. h. 
lib: 

specifies the directory in which the linker can find the libraries and 
other modules needed to build executable files. For example, the 
following Shell command indicates that the libraries are in the 
directory sc /lib on the work: volume: 

assign lib: work:sc/lib 


If you have previous versions of the compiler installed on your system, 
make sure that these assign statements are assigned to the correct 
directories for Version 6. 

Version 6 does not use the QUAD : device used by previous versions. 
Instead, Version 6 buffers the intermediate code in memory as long as 
possible. If it runs out of memory, it spills the information to a disk file. 


Setting Environment Variables 

The various tools in the SAS/C Development System sometimes require 
information in environment variables. For example, the sc command 
looks for default options in a file called scoptions; if the compiler does 
not find such a file in the current directory, it looks in the environment 
variable ENV: sc/scoptions. 

Environment variables are stored in the logical device ENV : in files 
with the same name as the variable. ENV : is usually assigned to the 
ram: device or some other temporary location. You can set environment 
variables from the Shell with the setenv command. 

All SAS/C utilities that use environment variables access them from the 
ENV: sc subdirectory, so be sure to create this subdirectory in env : 
each time you boot your machine. Under AmigaDOS 2.0, the installation 
program creates this subdirectory by creating the directory ENVARC: SC. 
Under AmigaDOS 1.3, ENVARC: does not necessarily exist, so you must 
make sure that the env : SC subdirectory is created each time you boot 
your machine. 

To save configuration changes permanently, you can create a directory 
and assign this directory to ENVARC: in your s : user-startup file. 

To set your AmigaDOS 1.3 or 1.2 system up to permanently store 
environment variable changes, follow these steps: 
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1. Create a permanent directory (not in ram:) in which to store the 
environment variables. Create a subdirectory called sc in this 
directory using the makedir command: 

makedir directory-path 
makedir directory-path/ sc 

2. Edit your s : user-startup file. 

o If you are running AmigaDOS 1.2, insert the following lines 
anywhere in the file: 

assign envarc: directory-path 
makedir RAM:Env 
assign ENV: RAM:Env 
copy envarc: env: all 

□ If you are running AmigaDOS 1.3, insert the following lines 
anywhere in the file: 

assign envarc: directory-path 
copy envarc: env: all 

3. Save your s :user-startup file. 

The changes you have made will take effect the next time you reboot your 
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Introduction 

This chapter introduces the primary features of the SAS/C Development 
System. It shows you how to perform the following tasks: 

a set up a project 

□ set compiler options for the project 
a create a C or C + + source file 

□ compile, link, and run a C or C + + program 

□ use the debugger to look at your program. 

Each of the tools used to perform these tasks are described in more 
detail in subsequent chapters in this book and in SAS/C Development 
System User’s Guide, Volume 2: Debugger, Utilities, Assembler. 

The SAS/C Development System provides an environment based on 
Intuition from which you can perform each of these tasks. However, you 
can also perform these tasks from the Shell. 

With the SAS/C Development System, developing a C+ + program is 
much like developing a C program. You can edit, compile, link, and run 
both C and C++ programs either by entering the sc command from the 
Shell or by clicking on the appropriate icon from the Workbench. The 
tasks described in this chapter work equally well for a C+ + program as 
they do for a C program. 

Note: If you are upgrading from previous editions, you may want to 
read Appendix 5, “Converting From Version 5 to Version 6," before you 
continue with this chapter. 
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Using SAS/C Tools from the Workbench 
Screen 

The following sections describe how to use the SAS/C Development 
System from the Workbench screen. Specifically, these sections discuss 
the following: 

□ setting up a project using the scsetup utility 

□ creating a source file using the s e editor 

□ setting compiler options for the project using s copts 

□ compiling and linking a program using the Build icon 

□ running your program 

□ using the debugger to look at your program. 

This chapter provides example directions that you can enter on your 
machine as you read through the chapter. These example directions 
illustrate how the many features of the SAS/C Development System work 
together. 

As you work through the example directions, the SAS/C Development 
System creates several icons. The icons it creates depend on the filename 
extension of the file you create. The last section in this chapter, “Using 
Icons,” describes the default icons for each of these files and how to 
customize these icons. 

Setting Up a To make your development work easier, you can set up either a new or 
Project existing project using the scsetup utility. When you set up a project, 
scsetup creates icons for any files or directories that already exist in 
the project and copies the contents of the sc : starter_pro ject 
directory into the project. The starter_pro ject directory contains 
icons for each of the tools you need most often during your development 
work: 


Build 

Debug 

Edit 


Find 


starts the smake utility, smake is a utility that helps you 
manage projects that are composed of many files, 
starts the CodeProbe Source Level Debugger. 


starts the editor, se. you can substitute your own editor 
for se by selecting Info from the Workbench pull-down 
menu and changing the default tool in the Edit icon from 
s c : c / s e to your editor. 


runs the smf ind utility, smf ind asks you to enter a 
string for which you want to search, runs the grep utility, 
and places the results in the message browser (scrasg) 
window. You can click an occurrence of the string, and 
scmsg invokes your editor on that file at the correct line. 
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Creating a 
Source File 
with se 


SCoptions starts the scopts utility and allows you to specify the 
compiler options with which you most often want to 
compile the programs in the directory you are setting up. 

It is recommended that you do not place your source code in the sc 
directory tree. Installing updates to the SAS/C Development System is 
easier if you can replace the entire directory without worrying about 
losing any of your own program files. 

To set up a project, run the scsetup utility by double-clicking the 
scsetup icon in the sc:c drawer, scsetup asks you for the name of 
the new project drawer (directory). For example, to create a new 
directory called c stuff on the Work: volume, you would enter: 

Horkicstuf f 

scsetup creates a new directory called cstuf f in Work: that contains 
the five icons described previously. 

For more information about the scsetup utility, refer to SAS/C 
Development System User’s Guide, Volume 2. 

After you set up a directory for your source files, you can start entering 
your programs. To create a new file, double-click on the Edit icon to 
start the se editor, se displays a window into which you can enter your 
program. 

Type in the following C program: 

linclude <stdio.h> 
linclude <tnath.h> 
i include <proto/dos.h> 

int main(void) 


int 

double d 
d=i/2; 

printf("i « Kd, d=X2. 1f\n", i,d) ; 
Delay(60) ; 
return! 0) ; 


You can also use the C+ + equivalent of this program to work through 
the example directions in this chapter. If you use the C + + example 



instead of the C example, the text produced on your screen will differ 
slightly from that shown in the displays shown in this chapter. The C + + 
equivalent of this program is as follows: 

{include <iostream.h> 

{include <math.h> 

{include <iomanip.h> 

{include <proto/dos.h> 

int main(void) 


int i«42; 
double d 

d«( double) i/2; 

cout << "i=" << i «", d=" « setprecision(3) « 
setiosflags(ios: sshowpoint) « d « "\n"; 
Delay ( 60 ) ; 
return! 0) ; 


Note: Enter the text for the program you choose exactly as shown. 
The semicolon missing from the declaration of d produces an error 
message that is used to illustrate scmsg, the message browser utility. 

If you enter any text differently from that shown here, simply use the 
backspace or delete key to delete the incorrect characters and correct the 
error. When you have finished entering the program, you must name the 
file, save it, and close the editor window as follows: 

1. Press and hold the right mouse button to display the se menu. 

2. Point to the Project heading in the menu bar to open the Project 
menu. 

3. Select the Rename option. At the bottom of the screen, se asks you 
to enter a new filename for the current file. 

4. Type example . c if you are using the C example or example . cxx 
if you are using the C+ + example, and press Return. 

5. Hold down the right Amiga key and press the letter S to save the 
file and close the editor window. 

Under AmigaDOS 1.3, the icon for this new file is not displayed until you 
close and reopen the window for the directory in which you created the 
file. If necessary, close and reopen the window to display the icon for 
example. c (or example . cxx). 
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For more information about the se editor, see Chapter 4, “Using se,” 
and Chapter 5, “Controlling se." 


Compiling, 
Linking, and 
Running Your 
Program 


After you have created a source program using the editor, you can 
compile, link, and run your program. If you want to compile and link 
your program with the default compiler options, simply double-click on 
the Build icon. However, if you want to change the default values or 
specify additional options, you can use the scopts utility. With scopts, 
you can set compiler options simply by clicking on the option. 

To successfully run the example shown in this chapter, you need to set 
additional compiler options. 


Setting Compiler Options with scopts 

Usually, you compile all of the programs in a project with the same 
compiler options. The scopts utility allows you to click on the options 
with which you want to compile and to save the options in an 
scoptions file in the project drawer. 

To run scopts, double-click on the SCoptions icon, scopts 
displays the first of several windows on which you can select the options 
with which you want to compile. 

To run the example . c or example . cxx program, you must specify 
the math=standard and the link options. To use the message 
browser as described in the section “Compiling and Linking with the 
Build icon,” you must specify the errorrexx option. Also, to use the 
CodeProbe debugger as described in the section “Debugging Your 
Program,” later in this chapter, you must specify the 
debug=symbolf lush option. 

The link option appears on the first screen that scopts displays, the 
SAS/C Compiler Options Index screen, as shown in Display 2.1. 



Display 2.1 
The SAS/C Compiler 
Options Index Screen 



To select the link option, click once on the NoLink cycle gadget. The 
gadget changes colors, and the text now reads Link. 

To select the math=standard option, click on the CODE 
OPTIONS . . . gadget, and then click once on the NoMath gadget. 
NoMath changes to Math= standard. Click on OK to return to the 
SAS/C Compiler Options Index screen. 

To select the debug option, click on the COMPILER OPTIONS . . . 
gadget, and then click three times on the NoDebug gadget. NoDebug 
changes to Debug=SymbolFlush. Click on the OK gadget to return to 
the SAS/C Compiler Options Index screen. 

To select the errorrexx option, click once on the MESSAGE 
OPTIONS . . . gadget, and then click on the NoErrorRexx gadget. 
NoErrorRexx changes to ErrorRexx. Click on OK to return to the 
SAS/C Compiler Options Index screen. 

To save the option settings, click on the Save gadget. The scopts 
utility saves the options you select in the file scoptions in the project 
directory. When you compile your program, the compiler reads the 
options from scoptions. 

For more information about the scopts utility, refer to SAS/C 
Development System User’s Guide, Volume 2. 
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Display 2.2 
The SAS/C Message 
Browser Window 


Compiling and Linking with the Build icon 

After you have selected the appropriate options, you can compile and link 
your program by double-clicking the Build icon to start the smake 
utility. 

smake examines the drawer and determines that it contains, in this 
case, only one C (or C+ +) source file, example . c (or example . cxx). 
smake then invokes the sc command to compile example. c or 
example. cxx using the options you specified with the scopts utility. 

When the compiler finds the missing semicolon in your program, the 
compiler invokes scmsg, the message browser, scrasg opens a window 
in which it displays each of the messages generated by the compiler. 
Display 2.2 shows the message browser window generated when you 
compile example. c. 



Double-click on the message in the message browser window, and the 
message browser invokes the editor on the file and line number specified 
in the message, as shown in Display 2.3. 
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Correct the error by inserting a semicolon at the end of the declaration 
for d. Save the corrected file by selecting the Save & Close option from 
the Project menu or by pressing Right Amiga-S. 

Close the message browser window by clicking on the Close gadget, 
and then close the smake window by pressing Return. 

Recompile and link your program (also referred to as rebuilding your 
program) by double-clicking on the Build icon. As before, smake 
invokes the sc command to recompile your file, smake then invokes the 
linker, slink, to produce the executable module, example. The linker 
also creates an icon for the executable module. (If you are running under 
AmigaDOS 1.3, you need to close then reopen the project drawer to see 
the icon for example.) 

For more information about the scmsg and smake utilities, refer to 
SAS/C Development System User’s Guide, Volume 2. 

Running Your Program 

The build process produces an executable module and creates an icon for 
this module in the project directory. If the icon for this module is not 
displayed, close and reopen the window for the directory in which you 
created the file. To run example, double-click on the example icon. 

When you run a program from the Workbench screen that uses 
standard input or output, the compiler opens a standard I/O window in 
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which your program can display output. In the case of the example 
program, the output is as follows: 

i = 42, d=21 .00 

If you are running under AmigaDOS 1.3, this window closes as soon as 
your program is finished running. For short programs, this window 
opens and closes so fast that it is difficult to see what is displayed in it. 

To make the window stay open for at least a second, the example 
program calls the AmigaDOS function Delay. If you are running under 
AmigaDOS 2.0, this window remains open until you click on its Close 
gadget. For information on changing the attributes of this window, see 
Chapter 9, “Running Your Program from the Workbench Screen.” 

Note: The compiler’s executable modules are now AmigaDOS shared 
libraries, so they remain in memory after you have compiled your 
application. They are automatically flushed out of memory if they are not 
in use and another program needs the memory. However, if you run out 
of fast memory, the operating system starts using chip memory before 
flushing the libraries. Chip memory is much slower than fast memory on 
machines with faster processors, so this may slow down your program. 

If you are running AmigaDOS 2.0 and your program appears to be 
running slowly, use the AmigaDOS avail command as follows to flush 
any shared libraries before rerunning your program: 

avail flush 

Debugging Your When you compile your program with the debug option, you can use the 
Program CodeProbe debugger to monitor the behavior of your program, line-by- 
line, as it executes. 

To run the debugger with the example file, click once on the Debug 
icon, then hold down the Shift key and double-click on the icon for the 
executable module. As shown in Display 2.4, CodeProbe opens two 
windows: the Source window that contains the source code for your 
program and the Dialog window into which you can enter CodeProbe 
commands. 
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Display 2.4 
CodeProbe Windows 
with example. c 



CodeProbe stops on the first line of your main program. 

To step through your program one line at a time, you can press the 
Return key. Pressing the Return key is equivalent to entering the 
proceed command. The current (highlighted) line in the Source window 
is the line that will execute next if you press Return. Press Return until 
the line containing print f is the current line. 

To display the value of a variable, you can use the display command, 
which you can abbreviate as d. To display the value of the variable d, 
enter d d on the command line of the Dialog window. If you have 
already stepped through the line containing d=i/ 2 , the debugger displays 
21 as the value of d. 

To finish executing your program, enter g (for go) on the command 
line of the Dialog window. You should always finish executing your 
program before quitting CodeProbe, or your machine may be left in an 
uncertain state and may crash later for no reason. To exit from the 
debugger, enter q (for quit). 

The Debugger has considerably more capabilities than those described 
here. For a complete description of the CodeProbe debugger, refer to 
SAS/C Development System User’s Guide, Volume 2. 


Using Your SAS/C Development System 23 


Creating a 
Source File 
with se 


Compiling, 
Linking, and 
Running Your 
Program 


Using SAS/C Tools from the Shell 

The following sections describe how to use the SAS/C Development 
System from the Shell. Specifically, these sections discuss the following: 

□ creating a source file using the se editor 

□ setting compiler options for the project using s copts 

□ compiling and linking a program using the sc command 

□ running your program 

□ using the debugger to look at your program. 

If you are doing all of your work from the Shell, you do not need to use 
scsetup to set up a directory for your source files. However, you 
should create a new working directory using the AmigaDOS makedir 
command. It is recommended that you do not place your source code in 
the sc directory tree. Installing updates to the SAS/C Development 
System is easier if you can replace the entire directory without worrying 
about losing any of your own program files. 

After you have created a directory for your source files, you can start 
entering your programs. To create a new file, enter the se command: 

se example. c 


or 


se example. cxx 

se displays a window into which you can enter your program. 

The se editor works the same whether you start it from the 
Workbench screen or from the Shell. See “Creating a Source File with 
se” under the previous section, “Using SAS/C Tools from the Workbench 
Screen,” for a description of entering a sample program. However, you 
do not need to name the file using the Rename option as described in the 
previous example. 

Of course, after you save the file and close the window, icons are not 
displayed. You are prompted for another command. 

For more information about the se editor, see Chapters 4 and 5 in 
Part 2, “Using the Screen Editor (se).” 

After you have created a source program using the editor, you can 
compile, link, and run your program. If you want to compile your 
program with the default compiler options, simply enter the s c command 
followed by the name of the source file. However, to successfully run the 



examples shown in this chapter, you need to set additional compiler 
options. From the Shell, you can set compiler options using the scopts 
utility, or you can specify the compiler options on the sc command line. 
The next section, “Setting Compiler Options with scopts,” describes two 
different ways to use the set options from the Shell. The section 
“Compiling and Linking with sc” describes how to specify options on the 
sc command line. 

Setting Compiler Options with scopts 

Usually, you compile all of the programs in a project with the same 
compiler options. The scopts utility allows you to set and save the 
options with which you want to compile the programs in a project. 

From the Shell, you can run scopts in two different ways: 

□ You can enter the scopts command followed by the options with 
which you want to compile. For the example programs in this chapter, 
you should enter the following command: 

scopts math=standard debug=symbolf lush errorrexx link 

You can enter the options in uppercase, lowercase, or in mixed case. 
When you specify options on the scopts command, the scopts 
utility does the following: 

1. reads the scoptions file in the current directory, if it exists 

2. adds or changes the options, depending on the options you 
specify on the scopts command 

3. writes the new option settings to the scoptions file in the 
current directory. 

a You can enter the scopts command without specifying options and 
use the scopts screens to set the options: 

scopts 

scopts displays the first of several windows on which you can select 
the options with which you want to compile. For the example program 
in this chapter, you should select the math=standard, link, 
errorrexx, and debug=symbolf lush options as described in 
“Setting Compiler Options with scopts” under the previous section, 
“Using SAS/C Tools from the Workbench Screen.” 

The scopts utility saves the options you select in the file scoptions 
in the project directory. When you compile your program, the compiler 
reads the options from scoptions. 
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For more information about the sc opts utility, refer to SAS/C 
Development System User’s Guide, Volume 2. 

Compiling and Linking with sc 

If you chose to use s copts to set compiler options, then you can 
compile and link your example.c program by entering the sc 
command as follows: 

sc example.c 

If you are using the C+ + example, you would enter: 
sc example. cxx 

sc reads the options from the scoptions file and compiles your 
program. 

However, if you chose not to use s copts to set compiler options, you 
must enter the following command to compile and link the example . c 
program: 

sc math=standard debug=symbolf lush errorrexx link example.c 

If you are using the C+ + example, you would enter: 

sc math=standard debug=symbolflush errorrexx link example. cxx 

Whether you used scopts or chose to specify the options on the 
command line, you specified the link option, so the compiler calls 
slink to link your program using the correct libraries. If your program 
links correctly, the linker creates an executable module named example. 

When the compiler finds the missing semicolon in your program, the 
compiler invokes scmsg, the message browser, scmsg opens a window 
in which it displays each of the messages generated by the compiler. 
Display 2.2, earlier in this chapter, shows the message browser window 
generated when you compile example.c (or example . cxx). However, 
Display 2.2 shows the smake window behind the message browser 
window. On your machine, you will see a Shell window. 

Double-click on the message in the message browser window. The 
message browser invokes the editor on the file and line number specified 
in the message, as shown in Display 2.3, also shown earlier in this 
chapter. 

Correct the error by inserting a semicolon at the end of the declaration 
for d. Save the corrected file by selecting the Save & Close option from 
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the Project menu or by pressing Right Amiga-S. Close the message 
browser window by clicking on the Close gadget. 

Recompile and link your program by entering the sc command as 
before, slink produces the executable module example. 

For more information about the sc command, see Chapter 8, 
“Compiling and Linking Your Program.” 

Running Your Program 

To run a program, enter the program name at the AmigaDOS prompt. To 
run example, enter the following: 

example 

The example program displays the following output: 
i = «2, d-21.00 

Note: The compiler’s executable modules are now AmigaDOS shared 
libraries, so they remain in memory after you have compiled your 
application. They are automatically flushed out of memory if they are not 
in use and another program needs the memory. However, if you run out 
of fast memory, the operating system starts using chip memory before 
flushing the libraries. Chip memory is much slower than fast memory on 
machines with faster processors, so this may slow down your program. 

If you are running AmigaDOS 2.0 and your program appears to be 
running slowly, use the AmigaDOS avail command as follows to flush 
any shared libraries before rerunning your program: 

avail flush 

Debugging Your When you compile your program with the debug option, you can use the 
Program CodeProbe debugger to monitor the behavior of your program, line-by- 
line, as it executes. 

To run the debugger with the example file, enter the following 
command at the Shell prompt: 

cpr example 

As shown in Display 2.4, CodeProbe opens two windows: the Source 
window that contains the source code for your program and the Dialog 
window into which you can enter CodeProbe commands. 
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Enter debugger commands as described in “Debugging Your Program” 
under the previous section, “Using SAS/C Tools from the Workbench 
Screen.” 

To finish executing your program, enter g (for go) on the command 
line of the Dialog window. You should always finish executing your 
program before quitting CodeProbe, or your machine may be left in an 
uncertain state and may crash later for no reason. To exit from the 
debugger, enter q (for quit). 

The Debugger has considerably more capabilities than those described 
here. For a complete description of the CodeProbe debugger, refer to 
SAS/C Development System User’s Guide, Volume 2. 


Using Icons 

The tools included with the SAS/C Development System produce icons for 
most files that they generate. The sc : icons drawer contains template 
icons used by these tools. The icons in this drawer all have names 
starting with def_ With the exception of def_exe and def_se, the 
letter or letters after the def_ represent the file extension of the files for 
which the icon is intended. For example, the de f _c icon is the icon for 
files that end in . c (C source files), and the def_h icon is the icon for 
files that end in . h (C header files). If a file does not have an extension 
(that is, the filename does not contain a period), the entire filename is 
used as an extension. Therefore, you can create a default icon for 
sraakef ile files called def_smakef ile. If a SAS/C tool needs to 
create an icon, it copies the icon matching the file’s extension from 
sc:icons to the correct directory and renames the icon to match the 
new filename. 

If you save a file for which the editor cannot find an icon in 
sc : icons, the editor uses the default icon def_se. Whenever the 
linker creates icons for executable modules (which do not have filename 
extensions), it uses the icon def_exe. 

The following table fists, for each tool that creates icons, the different 
types of items for which the SAS/C tools create icons and the default icon 



Command Item 


Icon 


sc listing files 

object files 
preprocessor output 
C prototypes 
GST files 

slink executable programs 

map files 

se C source files 

C+ + source 
any saved file 

scsetup 


def_lst 

def_o 

def_p 

def_h 

def_gst 

def_exe 

def_map 

def_c 

def_cxx, def_cpp, def_cc 
def_se is used if the correct icon 
does not exist 


creates icons for any file with an extension for which an 
icon exists in sc : icons. 


By default, the SAS/C Development System does not create icons for 
object ( . o) files. However, the compiler and assembler check for an icon 
called de f_o when they create an object file. If you want to see icons for 
object files, create an icon named def_o. info using any icon editor 
and save it to the sc : icons drawer under the name def_o. 

To prevent all of the SAS/C commands from creating icons, rename the 
sc : icons drawer to sc : noicons or to any other name you like. If a 
tool cannot find the icons drawer, it does not create an icon. 

To prevent a specific type of icon from appearing, rename or delete the 
template for that icon from the sc : icons drawer. For example, if you 
do not want your header ( . h) files to have icons, rename or delete the 
def_h icon. 

You can modify the icons in the sc: icons drawer in any way you 
choose. For example, you could replace the provided imagery with your 
own art work. 

For additional information on using icons, refer to the descriptions of 
the Information option or Information window in Using the System 
Software (Commodore-Amiga, Inc. 1990). 
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Introduction 

This chapter describes how to get help with any of the features of the 

SAS/C Development System. You have three primary sources of help: 

□ Appendix 1, “Solving Common Problems.” Appendix 1 describes 
solutions to the questions that users ask most frequently when they 
contact the Technical Support Division. This appendix also includes 
Questions that the Technical Support Division anticipates will be 
generated by the conversion to Version 6. 

□ The online help system. This system describes how to use each of the 
features provided by the SAS/C Development System. 

□ The Technical Support Division. You can contact the Technical Support 
Division if, for example, the compiler generates bad object code or 
error messages for correct code. Read the section “Contacting the 
Technical Support Division,” later in this chapter, before contacting the 
Technical Support Division. 


Using the Help System 

The SAS/C Development System provides an extensive online help facility 
using the AmigaGuide hypertext system provided by Commodore. From 
within se, scopts, scmsg, and CodeProbe, you can display help 
information by pressing the Help key. Within CodeProbe, you can also 
enter the help command on the command line. Display 3.1 shows the 
help screen that is displayed when you press the Help key while inside 
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Display 3.1 
Editor Help Screen 
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Delete to End of Line .. Ctrl-E 
Restore Deleted Line ... BlbY . 
I Configuration Screen i .. CtrM 


You can use the schelp program in the sc : examples/cback 
directory to set up the Control-Help key sequence to display a main menu 
for all of the help information for the SAS/C Development System. For a 
complete description of how to use this program, refer to the comments 
at the beginning of the schelp. c and READ. me files in the 
sc : examples/cback directory. If you load schelp and then press 
Control-Help, the system displays the screen shown in Display 3.2. 
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You can also display help information by invoking the AmigaGuide 
system directly with the following command: 


amigaguide database-name 


The help databases are located in the directory sc : help. You can 
specify one of the following databases: 


scmsg. guide 

describes the error and warning messages returned by the compiler. 
When you press the Help key from within scmsg, you are accessing 
this database, 
cpr . guide 

describes the purpose of and parameters accepted by each of the 
CodeProbe commands. When you press the Help key from within 
CodeProbe, you are accessing this database, 
se . guide 

describes how to use the editor se. When you press the Help key 
from within the editor, you are accessing this database, 
sc—util .guide 

describes how to use each of the utilities provided with the SAS/C 
Development System. 
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Deciding When to 
Call Technical 
Support 


sc . guide 

describes each of the options you can specify in the sc command. 
When you press the Help key from within scopts, you are accessing 
this database. 
sc_lib. guide 

describes each of the library functions. This database also allows you 
to display lists of functions by category or view an alphabetical list of 
all functions. 


To navigate through a database, simply click on any of the buttons that 
appear on a screen or select an option from the menu bar. The menu bar 
on all of the help screens contains the following options: 


Contents 

Index 

Help 

Retrace 

Browse < 
Browse > 


displays the main help screen for the database that you 
are viewing. 

is a standard AmigaGuide option that is not used by the 
SAS/C Development System, 
displays information about using the help facility, 
backtracks through the help screens that you have already 
displayed. 

displays the previous screen in the database, 
displays the next screen in the database. 


To exit the help system, click on the Close gadget. 


Contacting the Technical Support Division 

When you purchased the SAS/C Development System, you received 
access to the SAS Institute Technical Support Division. Technical Support 
can help you with unexpected problems that might arise with the 
compiler. Technical Support also gathers users’ comments on the current 
product and their suggestions for enhancements. 

Before you call the Technical Support Division, read through Appendix 1, 
“Solving Common Problems." This appendix describes the solutions to 
several frequently encountered problems. 

If you cannot find the answer to your problem in Appendix 1, you may 
need to call Technical Support. The following list describes some of the 
more common situations for which you should call Technical Support: 

□ The compiler generates an error for code that is correct. 

□ The compiler does not generate an error or warning for code that is 
incorrect. 
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□ The compiler generates bad object code. 

□ The compiler detects an internal error (CXERR) condition. 

□ The compiler or any utilities crash or end abnormally. 

□ The library functions or utilities do not perform as specified. 

d The manuals contain errors or do not provide enough information. 

Contacting If you live in the United States, Europe, or Canada, you can contact the 
Technical Technical Support Division in writing, by phone, or by fax: 

Support by 
Phone, Mail, 

or Fax Address: SAS Institute Inc. 

ATTN: Amiga SAS/C Technical Support 

SAS Campus Drive 

Cary, North Carolina 27513 

USA 

Phone: 919-677-8009 

Fax: 919-677-8134 

If you live in Australia, you should contact our Australian office: 


Address: SAS Institute Australia Pty. Ltd. 

ATTN: Amiga SAS/C Technical Support 
Private Bag No. 52 
Lane Cove, NSW 2066 
Phone: (02) 428 0428 

Fax: (02) 418 7211 

If you live in New Zealand, you should contact our New Zealand office: 


Address: SAS Institute (NZ) Ltd. 

ATTN: Amiga SAS/C Technical Support 
PO Box 10-109 
The Terrace 
Wellington 

Phone: (04) 727 595 

Fax: (04) 727 055 
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Whether you choose to call, send a letter, or send a fax, make sure you 
include or have with you all of the information described in the section 
“Collecting the Information Needed by Technical Support.” 

Contacting BIX (Byte Information Exchange) is a subscription service bulletin board 
Technical system available to users in Canada and the Continental United States. 
Support through You can contact BIX at the following address: 

BIX 


Address: BIX/General Videotex Corporation 

1030 Massachusetts Avenue 
Cambridge, MA 02138 
USA 

Phone: 1-800-695-4775 (outside Massachusetts) 

617-354-4137 (inside Massachusetts) 


You can sign up for a BIX subscription as follows: 

1. Through a modem, dial BIX at 1-800-225-4129. 

2. At the login: prompt, enter bix. 

3. At the Name? prompt, enter bix . amiga. 

When you subscribe to BIX, you receive a user’s manual that covers all 
aspects of their services, including: 

□ the various conferences available 

□ how to access a conference 

a how to access source listings. 

SAS Institute maintains a support conference on BIX named sas . c. 
This conference is monitored Monday through Friday for new messages. 
You can contact Technical Support by posting messages to this 
conference. 

► Caution Do not post your registration number to the public conference. 

You can also send private email messages on BIX to the ID sas . c (the 
same name as the conference). 

Whether you choose to post to the public conference sas . c or to send 
a private message, make sure you include all of the information described 
in the section “Collecting the Information Needed by Technical Support.” 

Contacting You can also contact the Technical Support Division through Internet 
T echnical using the EMITS (Electronic Mail Interface to Technical Support) facility. 

Support through 
Internet or 
Usenet 
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EMITS logs your mail for the attention for the Technical Support Division 
and sends an email message acknowledging receipt of your mail. 

Before you can use this facility, you must: 


□ 


register with SAS Institute. We cannot register you for EMITS until we 
have received and processed your registration card. If you have 
registered previous versions of the compiler, then you are already 
registered with SAS Institute. If you have not sent in the registration 
card from previous versions of the compiler, complete the registration 
card and send it to SAS Institute. Please wait two weeks before trying 
to register with EMITS. 

register with EMITS by sending a message containing the following 
lines to supportasas . com: 


. /register =your name 
. / s i t e = registration number 

. /company=company name (or your name if registering a private copy) 
. /phon e=phone number 

Include the word EMITS in the subject of the message. Begin each line 
in column 1. 


Here is an example: 


./register=John Doe 
. /site=SAS6-000001 
./company=Jane Doe 
. /phone» ( 555)555-5555 


Note: Your phone number does not need to conform to this syntax. 
You can specify phone numbers in any form necessary. 

EMITS extracts your email address from the header of your message 
and uses this address as your account ID. If you have accounts on 
multiple machines, register from the same host system that you want to 
use for sending messages to the Technical Support Division, or you may 
register from multiple machines if you want to send messages from more 
than one machine. 

Mail that does not include all of this information or that is syntactically 
incorrect is returned to you. If you have any problems registering with 
EMITS, please contact the Technical Support Division as described in 
“Contacting Technical Support by Phone, Mail, or Fax.” 

When your account has been added, EMITS notifies you by email and 
sends you a complete guide to using EMITS. 
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To request the help file for EMITS, send a message containing the 
help command as follows: 


./help 


Do not include any additional requests or any problem reports in the 
same message as the request for the help file. 

Periodically, new features are added to EMITS and the help file is 
updated. When the help file is updated, it will be automatically mailed to 
all users registered with EMITS. 

There are several points to remember when sending mail to EMITS. 

□ All email messages to EMITS should be sent to supports sas .com. 

□ All email messages intended for EMITS must contain the words EMITS 
in the subject. 

□ EMITS is not case sensitive. 

□ EMITS can process only one request for each email message you send. 
For example, send two separate email messages to 
supportasas .com to register and to request the help file. 

□ EMITS acknowledges every entry you send. If you do not receive an 
acknowledgment containing the tracking number assigned to your 
problem, SAS Institute did not receive your email message. 

When you contact Technical Support through EMITS, make sure you 
include in your message all of the information described in the next 
section. 


Collecting the 
Information 
Needed by 
Technical 
Support 


The Technical Support staff requires specific information before they can 
handle your questions. Include the following information in your 
correspondence, or have this information ready if you call: 

Registration number 

Technical Support cannot answer any questions unless you provide a 
valid registration number. This number is found on a cardboard sheet 
included with the compiler documentation. The postcard that is part of 
that sheet should be torn loose and mailed to SAS Institute as soon as 
possible after purchasing the compiler. Please keep the other portion 
of that sheet with your documentation. If you have upgraded the 
compiler from an older, registered release, your product should not 
contain a registration card. Continue to use your original registration 
number. If you decide to send in the new card, please note your old 
number, so that it may be removed from our database. If you do not 
know your registration number, please contact Book Sales at 
(919) 677-8000, extension 7001. 



Getting Help 37 


If you purchased your copy of the compiler from someone who has 
already registered with us, that person must contact Book Sales with 
the following information: 

□ their name, address, phone number, and registration number, so 
that their name may be removed from our database. 

o your name, address, phone number, and registration number so 
that you may be added to the database and become eligible for 
Technical Support. 

Version number 

The version number of the compiler is displayed in the header that 
appears on the screen each time you run the compiler. You can also 
display the version number with the AmigaDOS version command. 

Return address and phone number 

If you send a letter or fax, include your return address in the 
correspondence — not just on the envelope. Whether you call or 
write, Technical Support will need a phone number where you can be 
reached from 9:00 am to 5:00 pm EST. 

Complete problem description 

Include all error messages and symptoms of the problem. If you are 
not able to call when you have access to your machine, write down 
the following information before contacting Technical Support: 

□ the exact text of any error messages, guru meditation numbers, and 
so on, that you see on the screen 

□ whether the problem occurs when you are compiling, linking, or 
executing your program 

□ any commands, options, or code needed to consistently reproduce 
the problem (for example, compiler or linker options and CodeProbe 
commands). 

□ any parts of the product that you chose not to install. 

□ the configuration of your machine, including the type of processor, 
the amount of memory, and the version of the AmigaDOS operating 
system. 

If you have problems with a large piece of code, try to isolate the code 
that is causing the problem into a test case of 30 lines or less. 
Technical Support staff can respond faster if you can reduce the 
problem to a small test case. 
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An Example Bug The following is an example bug report showing the information that you 
Report should include when you contact Technical Support. 

I ran this using version 6.50 on an Amiga 4000 running AmigaDOS 
version 3.0. I was trying to run this: 

((include <stdio.h> 

int main (void) 

I 

double x = 3.5; 

printf("X = !Sf\n",x); 
return(0) ; 


I compiled it with NOSTKCHECK, DBG=SF, ANSI, and LINK. 

When I compile it, I get the message: 

Warning 625: Proper math library has not been included. 


When I run it, it prints "JSf" instead of "3.5". 


This report includes several important pieces of information: 

□ a complete description of the machine and operating system 

□ a complete test case that reproduces the problem each time it is 
compiled and run 

□ a list of all options used to compile and link 

□ a complete description of the symptoms of the problem, including the 
message number and text. 

If you send your report using EMITS, your name, phone number, and 
serial number are already on file, so you can omit that information. Also, 
if you are sending the problem to EMITS rather than writing a letter or 
sending a fax, you can include longer test cases in the . /data section. 
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Introduction 

This chapter describes how to use the editor, se. Specifically, this chapter 
describes how to: 

□ invoke the editor 

□ insert text into and delete text from a file 

□ search for and replace character strings 

□ create and use keystroke macros 

□ save your file and exit the editor 

□ open, close, and switch between windows 

□ compile your program from within se 

□ get help from within se. 

This chapter describes the most commonly used features of se. It does 
not cover all of the commands available or all of the ways in which you 
can execute commands. Chapter 5, “Controlling se,” contains 
comprehensive lists of the commands available in se. 

Note: The instructions in this chapter assume that you are using the 
default keystroke definitions. If you have customized your key definitions 
with the SE Configuration Window, use your customized keystrokes when 
required. 



Starting the Editor 

You can start se by: 

□ double-clicking on the Edit icon. 

□ double-clicking on the icon for a file created with se. 

□ entering the se command at the Shell prompt. 

The se command has the following format: 

se [option] [filename]... 

where option is one of the following: 

displays the se version number and copyright statement and exits se. 
If you specify the -v option, se ignores anything else you specify in 
the se command. You need the version number from this display if 
you call the Technical Support Division for help with se. 

-d filename 

uses the data file that you specify instead of se . dat. This file 
contains keyboard definitions and default information, including color, 
window size, and so on. When you start the editor, se looks for a 
data file. By default, se looks for se . dat in env : sc and, if it does 
not find the file, se looks in sc: env. You can tell se to use a 
different data file by specifying the filename with the -d option. 

If you start se by double-clicking on the Edit icon or by entering the 
se command without a filename, se displays an empty edit window. 

When you start se from the Shell prompt, you can specify the names 
of the files that you want to edit. If you specify more than one filename, 
se opens a window for each file, se displays the first file in the top 
window and the second file in the bottom window. If you enter more 
than two filenames, you must press the F6 (cycle windows) key to display 
the additional files. You can specify up to nine filenames on the se 
command line. 

For example, you can edit the files hello.c and example.c from 
the sc/examples directory by entering the following commands: 

cd sc: examples 
se hello.c example.c 

Display 4.1 shows the two edit windows displayed by se. 
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At the bottom of each edit window is a status line that shows, among 
other things, the name of the file in that window. The last two lines on 
the screen are the lines that se uses to display messages and to prompt 
you for additional information. 

You can have up to nine files open at one time. To open an additional 
file, select Open Window from the Windows pull-down menu, se asks 
you for the file that you want to open. If you are running AmigaDOS 2.0, 
se displays a file requester. Each open file is displayed in a different 
window, and you can switch between files by selecting Switch Windows 
from the Windows pull-down menu. The current window is the window 
that contains the cursor. 

The default text window size is 20 lines by 78 columns. You can set 
each window to occupy a half screen or a full screen by selecting Toggle 
Display Size from the Windows pull-down menu. 


Reading the Status Line 

The status line contains the following items: 

□ current line number. 

□ current column number. If you turn on the Column Display option 
from the SE Configuration Window, se displays the current column 
number in the status line. Chapter 6, “Customizing the Editor,” 
describes how to use the SE Configuration Window. 


□ current filename. 

□ the current mode. You can switch between two modes, insert mode 
and overwrite mode, by pressing the Insert key (NUM-0). In insert 
mode, any character you enter is inserted at the current cursor 
position. In overwrite mode, any character you enter replaces the 
character at the current cursor position. The default mode is insert. 

□ window number, se displays the window number within braces. For 
example, for window number 2, se displays { 2 ) . 

□ keystroke saver active indicator. By default, the Alt-n key sequence 
starts recording your keystrokes in that macro. On the status line, s e 
displays the number n that you entered. For more information on 
creating keystroke macros, see “Using Keystroke Macros,” later in this 
chapter. 

□ marked block indicator. When you mark a block of text, s e displays 
[ * ] in the status line. The section “Working with Blocks of Text,” 
later in this chapter describes how to mark a block of text. 


Moving Around in a File 

In addition to the arrow keys, you can use the following keys to move 
around in your file: 

Home (NUM-7) 

moves the cursor to the beginning of the current line 
End (NUM-1) 

moves the cursor to the end of the current line 
Control-Home 

moves the cursor to the beginning of the file 
Control-End 

moves the cursor to the end of the file 
PgUp (NUM-9) 

displays the previous page of text 
PgDn (NUM-3) 

displays the next page of text. 


Entering and Editing Text 

The following paragraphs describe the most common commands used to 
insert and delete characters, se offers many more commands that are 
described in Chapter 5, “Controlling se.” 

When you first open your file, you are in insert mode. Any character 
that you enter is inserted at the current cursor position. If you press the 
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Insert key, se switches to overwrite mode, and any character you enter 
replaces the character at the current cursor position. Each time you press 
the Insert key, you switch modes. 

As stated previously, the default window width is 78 columns. The 
maximum line length in se is 256 characters. If you have not selected 
Autowrap from the Options pull-down menu in the SE Configuration 
Window, then se does not automatically start a new line when you type 
past column 78. Instead, se moves the text to the left so that you can 
still see what you are typing. When you press Return, se redisplays the 
window beginning with column 1 and displays a greater than (>) sign at 
the right side of the screen on the line that exceeds 78 columns. (For 
more information about the Options pull-down menu, see Chapter 6, 
“Customizing the Editor.”) 

You can use the following keys to delete text: 

Backspace deletes the character to the left of the cursor 
Delete deletes the character at the cursor position 
Control- Y deletes the current line 

Control-E deletes all characters from the current cursor position to the 
end of the current line. 

If you decide you want to restore the last line that you deleted with 
Control- Y, press Alt-Y. 

Searching for The following sections describe the Search command and the Search and 
and Replacing Replace command. To use these commands, you can enter strings as 
Character Strings regular expressions or as simple character strings. By default, se expects 
you to enter regular expressions. Regular expressions are character 
strings that may contain characters that have special meanings. For 
example, abed, a little lamb, and [tT]+he$ are all valid regular 
expressions. “Entering Regular Expressions," later in this chapter, 
provides additional information on using regular expressions under se. 

If you select String Matching as the Searches Method in the SE 
Configuration Window, then se interprets any special regular expression 
symbols as plain text. 

Note: The Search and Search and Replace commands are case- 
sensitive by default, so you must enter the character string exactly as it 
appears in the file. To make these commands case-insensitive, choose Case 
Insensitive Search from the Options pull-down menu in the SE 
Configuration Window. 


Searching for Character Strings 

To search for a character string, press Right Amiga-F. i 
enter the string for which you want to search: 


> asks you to 



REGULAR EXPRESSION SEARCH STRING: (MENU KEY to search backwards) 

To search forward (from the current position toward the end) through 
the file, type the character string and press Return. To search backward 
(from the current position toward the beginning) through the file, press 
the F2 key (the Main Menu key), and se displays the following prompt: 

(BACKWARDS) REGULAR EXPRESSION SEARCH STRING: 

Type the character string and press Return. 

After you press Return, se positions the cursor at the first occurrence 
of the character string. To repeat the search, press Right Amiga-A. 

Replacing Character Strings 

To replace one character string with another character string, press Right 
Amiga-R. se displays the same prompt as if you had pressed Right 
Amiga-F. You can type the character string that you want to replace and 
press Return, or you can press the F2 key if you want to search 
backward through the file. If you press F2, se displays the same prompt 
as if you were simply searching for the string, and you should type the 
character string that you want to replace and press Return. 

After you enter the character string for which you want to search, se 
prompts you for a second character string: 

REPLACE STRING: 

Type the string with which you want to replace the first character string 
and press Return, se then asks you if you want to be prompted before it 
replaces any occurrences of the first string with the second string: 

REPLACE: Prompt No Prompt 

If you want se to ask you before it replaces any strings, select Prompt. 
(Use the arrow keys to highlight Prompt and press Return, or press the 
letter p.) 

If you select No Prompt, se replaces all occurrences of the first string 
with the second string from the current position through the remainder 
of the file. (That is, to the end of the file for a forward search or to the 
beginning of the file for a backward search). 

If you select Prompt, se positions the cursor at the first occurrence of 
the character string, and asks you what you want to do: 


REPLACE: Yes No Quit Global 
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Working with 
Blocks of Text 


Select one of the options: 

Yes replaces the string and positions the cursor at the next 
occurrence of the character string to be replaced. 

No moves the cursor to the next occurrence of the character string. 
Quit stops the search and replace without replacing any strings. 
Global replaces all remaining occurrences of the string without 
displaying any prompts. 

You can highlight your selection by pressing the arrow keys or by 
pressing the first letter of the option. 

Entering Regular Expressions 

As previously stated, regular expressions are character strings that may 
contain characters that have special meanings. Regular expressions are 
also referred to as patterns. 

Refer to the section “Specifying the Pattern” in the description of the 
grep utility in SAS/C Development System User’s Guide, Volume 2: 
Debugger, Utilities, Assembler, Version 6.0 for a complete description of 
entering regular expressions, se supports regular expressions in the 
same manner as grep except that you do not need to enclose in double 
quotes (“) a string that contains spaces. For example, to search for the 
string a little Iamb, you would enter a little lamb instead of "a 
little lamb". 

You can copy, delete, move, print, and write entire blocks of text within 
the same file, between different files, or to and from the clipboard. To 
perform an operation on a block of text, you must first mark the block. 
You can mark a block of text in one of two ways: 

□ Position your cursor on the first character that you want included in 
the block, and press Control-! . se displays a left bracket in the status 
line. Then, position your cursor after the last character that you want 
included in the block, and press Control-]. 

□ Position your mouse cursor on the first character that you want 
included in the block. Hold down the left mouse button, move the 
cursor to the last character that you want included in the block, and 
then release the mouse button. 

se displays the marked block in reverse video and displays [ * 1 in the 
status line. You can have only one marked block at a time. 

After you have marked a block, you can delete or print the block by 
selecting the appropriate option from the Block pull-down menu. You can 
move or copy the block to another open file by positioning the cursor at 
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the location to which you want to move or copy the block and selecting 
the appropriate option from the Block pull-down menu. You can also use 
the keyboard shortcuts displayed beside the menu selection. 

To write the block to a file that is not open, select the Write option 
from the Block pull-down menu, se asks you to enter the name of the file 
to which you want to write the text: 

write BLOCK TO FILE: Filename 

Type the appropriate filename and press Return, s e writes the block to 
the filename you enter. The block text replaces any text that is already in 
the file. 

If you mark a block of text and then decide that you do not want to 
perform any operations on the block, you can unmark the block by 
pressing Control-!, then Control-] without moving the cursor. 

Note: The Read option in the Block pull-down menu performs the 
same function as the Insert File option in the Project menu. 

Undoing Your se remembers the changes you entered for the last 50 lines that you 
Last Change changed, inserted, deleted, and so on. You can undo these changes with 
the undo command. You can run the undo command in any of three 
ways: 

□ press Right Amiga-U 

□ press Control-U 

□ select Undo Last Change from the Project menu. 

When you select the undo command, se displays a prompt depending on 
the last command you entered: 

UNDO — DELETE INSERTED LINE?: Yes No 

UNDO — DELETE ADDED BLOCK?: Yes No 

UNDO — RESTORE DELETED BLOCK?: Yes No 

UNDO — RESTORE DELETED LINE?: Yes No 

UNDO — RESTORE REPLACED LINE?: Yes No 

Select the appropriate answer and press Return. 

Note: se remembers changes for the last 50 lines only. If you delete 
or add a block of text larger than 50 lines, se remembers only the first 
50 lines. 
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Using Keystroke If you need to perform repeatedly a task that requires several keystrokes, 
Macros you may want to create a keystroke macro to do the task. If you save 
your keystrokes as a macro, then you can perform the task by pressing 
only the Alt key and a function key. 

Creating and Replaying Keystroke Macros 

To create a keystroke macro, hold down the Alt key and press a number 
(0-9) key (for example, Alt-0). The number that you press is displayed in 
the right side of the status line between the window number and the 
marked block indicator (if present), se displays the following message: 

Key Saver Begun 

Note: If you press 0, the status line shows the number 10. 

From this point, all of your keystrokes are stored as part of the macro. 
Enter all of the keystrokes necessary to perform the task. After you have 
completed the task, press Alt and the same number key again to stop 
recording keystrokes. To execute, or replay, the macro, press Alt-Fn, 
where n is the number you pressed to define the macro (for example, 
Alt-FlO). 

Any macros you define are saved until you exit from se. The following 
section, “Saving and Reloading Keystroke Macros,” describes how to save 
keystroke macros in a file and reuse them later. 

Saving and Reloading Keystroke Macros 

If you do not save your keystroke macros in a file or convert them to a 
key as described under “Assigning a Macro to a Different Key,” they are 
lost when you complete your editing session and terminate se. 

To save your keystroke macros in a file, select the Save Macros option 
from the Project pull-down menu, se prompts you for a filename in 
which to save the macros: 

SAVE MACRO FILE: SPECIFY MACRO FILENAME (default is SE.MAC) 

Type a filename and press the Return key. 

To reuse your macros, select the Load Macros option from the Project 
pull-down menu, se prompts you for the name of the file in which you 
saved the macro definitions: 


LOAD MACRO FILE: SPECIFY MACRO FILENAME (default is SE.MAC) 
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Type the filename and press the Return key. The file that you specify is 
loaded over any macro files that you may have already loaded, se does 
not check the file to determine if the file is a valid macro file. 

Assigning a Macro to a Different Key 

When you create a keystroke macro, that macro is assigned to one of the 
10 possible Alt-Fn key sequences. If necessary, you can assign one or 
more of the macros to a different key sequence. For example, you may 
want to assign the Alt-FlO macro to Control-Z. 

After you assign a macro to a key, you can edit and save the macro 
using the SE Configuration Window. 

To assign a keystroke macro to a different key sequence, select the 
Convert Macro to Key option from the Options pull-down menu, se asks 
you to enter the macro number: 

Enter the macro number to convert to a key ( 1-10) 

Type the appropriate number and press Return. To convert macro 
number 10, type the number 10, not just a 0 as you did when you 
created the macro. 

se displays the keymap portion of the Configuration Window. Select 
the key sequence to which you want to assign the macro by clicking on or 
pressing the appropriate keys such as the Control key and the letter Z. 
After you have selected the keys, click on the Close gadget. 

To save the macro assignment for your next editing session, you must 
redisplay the SE Configuration Window by selecting the Configuration 
Window option from the Options pull-down menu. Then, click on the 
Save gadget or select the Save As option from Project pull-down menu. 

Entering Control You can enter control characters into your text file by preceding the 

Characters control character with the se escape character, Control-\. For example, 
to enter a form feed character into your text file, press 
Control-X Control-L. 


Saving Your File and Exiting se 

After you have finished editing your file, you can save the file, exit the 
file without saving your changes, and/or exit se. 

You cannot save an unnamed file. If you started se by double-clicking 
on the Edit icon or by entering the se command without a filename, 
then you must name the file before you can save it. To name the file, 



select the Rename option from the Project pull-down menu, se asks you 
to enter a filename: 

ENTER NEW FILENAME for current file: 

Type the appropriate filename and press Return. You can now save the 
file and quit se. 

To save your file and/or quit the editor, select the appropriate option 
from the Project pull-down menu: 

Save & Close 

saves your file and closes the current window. If you have only one 
window open, this option also terminates se. If you have more than 
one window open, the next window becomes the current window. 
Close Window 

closes the current window. This option does not save your file. If you 
have only one window open, this option also terminates se. If you 
have more than one window open, the next window becomes the 
current window. 

Save & Continue 

saves your file. This option does not close any windows. 

Save & ReOpen 

saves and closes your file, then asks you for the name of a new file to 
edit. This option does not open an additional window to edit the new 
file. 

Exit SE 

terminates the editor. This option does not save your file. 

You may also use the keyboard shortcuts displayed beside the menu 
options. 


Managing Windows 

In se, you can have up to nine files open at one time, and each open file 
is displayed in a different window. 

To open an additional window, select the Open Window option from 
the Windows pull-down menu, se asks you for the name of the file to 
read into the new window: 

OPEN WINDOW: Filename (Menu Key for view mode only) 


Type the appropriate filename and press Return. 



If you have only one window open, that window occupies the entire 
screen. By default, if you open two or more windows, se displays two 
windows at a time in split-screen mode. In split-screen mode, each 
window occupies half of the screen. Display 4.1, earlier in this chapter, 
shows two windows in split-screen mode. 

In split-screen mode, you can move between the two currently 
displayed windows by pressing Control-F6. Within the same window, you 
can cycle through the remaining (hidden) windows by pressing F6. 

To switch between split-screen mode and full-screen mode, select the 
Toggle Display Size option from the Windows pull-down menu. To display 
the names of each open file, select the Display Names option from the 
Project pull-down menu. 


Compiling from within the Editor 

Before you compile your program, make sure that you have the correct 
options specified in scopts. To specify compiler options from within se, 
press Control-F4 to run the scopts utility. If you change any settings, 
save the new settings before exiting scopts. 

To compile your program, press F4. s e displays a message telling you 
that your program is compiling. If the compiler finds any errors in your 
program, it sends the errors to the scmsg utility, and scmsg displays 
the errors in the Message Browser window. To locate the line causing an 
error, double-click on the error message. To move to the next error, 
press F5. 

For additional information on using the scmsg and scopts utilities, 
refer to Chapter 2, “Using Your SAS/C Development System,” or to the 
description of the scmsg utility in SAS/C Development System User’s 
Guide, Volume 2. 


Getting Help 

To display help in se, press the Help key or press FI. se displays either 
the SAS/C Screen Editor Help menu or context-sensitive help information 
for the command you are executing. Chapter 3, “Getting Help,” describes 
how to use the help system. 
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Introduction 

This chapter describes all of the commands available within se and how 
to invoke each command. Some of the commands listed in this chapter 
are described in more detail in Chapter 4, “Using se.” 

Note: This chapter describes the default keystroke definitions. If you 
have customized your key definitions with the se configuration window, 
substitute your customized keystrokes when necessary. 

The first section in this chapter, “Selecting Menu Options,” describes 
the different ways in which you can select options. The remaining 
sections describe the options and commands you can use to perform 
specific tasks: 

□ moving around in a file 
a inserting text 

a deleting text 

□ marking, copying, deleting, and moving blocks of text 

□ searching for and replacing character strings 

□ opening, closing, and changing windows 

□ creating and using keystroke macros 

□ editing a new file 

□ saving your file and exiting the editor. 



Each section includes a table that shows, for each specific task, which 
keys/options to press/select to perform the task. For example, to move to 
a specific line in your file, you can: 

□ Press Control-L. 

□ Press Right Amiga-L. 

o Select the Line Number option from the Search pull-down menu. 


Selecting Menu Options 

You can select an option or enter a command in one of three ways: 

□ Select an option from a pull-down menu. 

□ Enter the appropriate accelerator key for the option or command. 
Many of the menu options are also associated with menu accelerator 
keys (also called keyboard shortcuts). These shortcuts are displayed to 
the right of the option in the pull-down menus. For example, the 
keyboard shortcut for the Save & Close option in the Project menu is 
Right Amiga-S. 

□ Select an option from the abbreviated menus displayed with the F2 
(Main Menu) key. If you press the F2 key, se displays an abbreviated 
menu of the most frequently used commands at the bottom of the 
screen: 

COMMAND: BCFMLOPRSQU 

Each of these options either displays a submenu or executes a 
command. For example, B displays the Block menu, and Q exits the 
editor. To display a brief description of an option, move the cursor to 
that option. 

To turn off the abbreviated menu, press F2 again. You can use the 
F2 key to toggle the abbreviated menu on and off. 

se also provides context-sensitive help that describes each command in 

detail. To display help information, press the Help key. 
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Moving Around in the File 

The following table lists the keys/options that you can use to move 
around in your file. 


Task 

Move up one line 
Move down one line 
Move left one character 
Move left one word 

Move right one character 
Move right one word 

Go to a specific line 

Go to the beginning of the line 

Go to the end of the line 

Go to the top of the file 

Go to the end of the file 

Move up one page 

Move down one page 

Scroll the text up 

Scroll the text down 

Go to the beginning of a marked block 

Go to the end of a marked block 


Key Menu/Option 

Up arrow 
Down arrow 
Left arrow 

Control-Left arrow 
Shift-Left arrow 

Right arrow 
Control-Right arrow 
Shift-Right arrow 

Control-L Search/Line Number 

Right Amiga-L 

Home 

End 

Control-Home 

Control-End 

PgUp 

PgDn 

Control-6 

Control-V 

Block/Beginning 

Block/End 
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Inserting Text 

The following table lists the keys and options that you can use to insert 
text into your file. 


Task 

Switch between Insert and Overwrite modes 

Insert a line before current line 

Restore deleted line 

Enter control characters 

Insert a file at current position 


Key Menu/Option 

Ins 

Control-I 

Alt-Y 

Control-\c 

Project/Insert File 


Deleting Text 

The following table lists the keys/options that you can use to delete text 
from your file. 


Task Key Menu/Option 

Delete current character Del 

Delete previous character Backspace 

Delete word Control-W 

Delete line Control-Y 

Delete from cursor position to end of line Control-E 

Delete a marked block Right Amiga-D 


Block/Delete 
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Working with Blocks of Text 

The following table lists the keys/options that you can use to mark, copy, 
move, insert, and delete blocks of text. For a more detailed description of 
these commands, see Chapter 4, “Using se.” 


Task 

Key 

Menu/Option 

Mark beginning of block 

Control-! 


Mark end of block 

Control-] 


Copy a marked block 

Right Amiga-C 

Block/Copy 

Delete a marked block 

Right Amiga-D 

Block/Delete 

Move a marked block 

Right Amiga-M 

Block/Move 

Print contents of a marked block 


Block/Print 

Read a disk file into the editor window 


Block/Read 

Write contents of marked block to a file 


Block/Write 

Go to the beginning of a marked block 


Block/Beginning 

Go to the end of a marked block 


Block/End 

Searching for and Replacing Strings 

The following table lists the keys/options that you can use to locate 
character strings and to replace a string with another string. For a more 
detailed description of these commands, see Chapter 4, “Using se.” 

Task 

Key 

Menu/Option 

Search for a character string 

Control-S 
Right Amiga-F 

Search/String Search 

Replace one character string with another 

Control-R 
Right Amiga-R 

Search/Search and Replace 

Repeat last search or replace command 

Alt-S 

Right Amiga-A 

Search/Search Again 
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Managing Windows 

The following table lists the keys/options that you can use to open, close, 
and cycle through windows. Some of these commands are described in 
more detail in Chapter 4, “Using se.” 


Task 

Key 

Menu/Option 

Switch window (in split-screen mode) 

Control-F6 

NUM-5 

Windows/Switch Windows 

Cycle windows (in full-screen mode) 

F6 


Change window size 

F9 

Windows/Toggle Display 
Size 

Switch between 20 lines and 45 lines 

NUM Enter 
Right Amiga-H 

Windows/Interlace Toggle 

Open new window 

Control-0 

Windows/Open Window 

Open a new Shell 

Control-F 

Windows/Create New CLI 

Move window front to back 

F10 


Close a window 

Right Amiga-Q 

Project/Close Window 


Changing Colors 

The colors used in the se windows are based on your Workbench colors. 
You can change the way the Workbench colors are used in the se 
windows with the keys listed in the following table. These keys allow you 
to cycle through the foreground and background colors. 


Task 


Key 


Cycle foreground colors 
Cycle background colors 


F7 

F8 
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Creating and Using Keystroke Macros 

The following table lists the keys/options that you can use to create, save, 
and load keystroke macros. For a more detailed description of these 
commands, see Chapter 4, “Using se.” 


Task 

Key 

Menu/Option 

Start/stop saving keystrokes 

Alt-n 


Execute a keystroke macro 

Alt-Fn 


Save macros in a file 


Project/Save Macros 

Load macros from a file 


Project/Load Macros 

Assign keystroke macro to a different key 


Options/Convert Macro to 
Key 


Editing a New File 

The following table lists the keys/options that you can use to open new 
files. For a more detailed description of these commands, see Chapter 4, 
“Using se.” 


Task 


Key 


Menu/Option 


Save current file and edit new file 
Open a new file in the current window 
Open a new file in a new window 


Right Amiga-N 
Right Amiga-0 
Control-0 


Project/Save & Reopen 
Project/Open New Window 
Windows/Open Window 
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Naming Files 

The following table lists the keys/options that you can use to change the 
names of files from inside se. For a more detailed description of these 
commands, see Chapter 4, “Using se.” 


Task Menu/Option 

Rename current file Project/Rename 

Display names of files being edited Project/Display Names 


Undoing Changes 

The following table lists the keys/options that you can use to undo your 
last change. 

Note: The action taken by the Undo Last Change option depends on 
the last command you entered. For a complete description of this option, 
see Chapter 4, “Using se." 


Task Key Menu/Option 

Restore the last line you deleted Alt-Y 

Undo last change Control-U Project/Undo Last Change 

Right Amiga-U 


Saving Your File and Exiting the Editor 

The following table lists the keys/options that you can use to save your 
file and exit the editor. For a more detailed description of these 
commands, see Chapter 4, “Using se.” 


Task 

Save the file in the current window 
Save the file and close the current window 
Save current file and edit new file 
Exit the editor without saving your file 


Key 

Right Amiga-W 
Right Amiga-S 
Right Amiga-N 
F3 

Right Amiga-X 


Menu/Option 

Project/Save & Continue 
Project/Save & Close 
Project/Save & Reopen 
Project/Exit SE 
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Introduction 

This chapter describes how to use the SE Configuration Window. The 
configuration window allows you to set options and change the functions 
assigned to different keys and key combinations ( sequences ). For example, 
you can do the following: 

□ set the input processing mode 

□ set tab stops 

□ turn on automatic indention 

□ set auto-indent stops 

□ specify whether searches are to be simple string searches or pattern 
searches 

□ change the command assigned to a key or key combination. 


Displaying the Configuration Window 

To display the SE Configuration Window shown in Display 6.1, open the 
Options pull-down menu on the se menu bar, and select the 
Configuration Window option. (Alternatively, you can press Control-M.) 
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Display 6.1 
se Configuration 
Window 



To display the configuration window menu bar, press and hold the right 
mouse button. The menu bar contains six pull-down menus: 

Project contains options that allow you to save any changes you make 
while in the configuration menu or to quit the configuration 
window without saving your changes. The sections “Saving 
the New Settings” and “Reusing Saved Settings,” later in this 
chapter, describe how to use the Project menu. 

Options allows you to specify several options that determine how the 
editor works. For example, you can specify how tab 
characters are processed, whether Search and Replace 
commands are case sensitive, whether the se status line 
shows the current column number, and so on. The section 
“Setting Other Options,” later in this chapter, describes how 
to use this option. 

Keys 1-4 lists the different commands that you can assign to a key or 
key combination. The following sections “Displaying Key 
Definitions” and “Setting Key Definitions” describe how to use 
these menus. 
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Displaying Key Definitions 

To display the command assigned to a key or key sequence, you can 

□ click on that key or key sequence in the keymap. 

□ press that key, if the key is a qualifier key. Qualifier keys are keys that 
modify the function of other keys, such as the Control key, the Alt key, 
the Shift key, and so on. 

For example, to display the definition of Control-F4 as shown in Display 
6.2, click on the Ctrl key and the F4 key. 



The name of the key or key sequence appears in the Key Name field, 

CTRL F4, and the command assigned to the key appears in the text 
gadget below the Key Name, CO. 

To determine the function of a specific command, open the Keys pull- 
down menus. These menus contain the explanations of each of the 
commands that you can assign to a key or key sequence. For example, the 
Keys 2 pull-down menu shows the function of the CO command as Set SC 
Options. 

The configuration window also displays the raw code and qualifier 
associated with a specific key combination. 
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Raw code is a hexadecimal code associated with a specific key on the 
keyboard by the hardware. The AmigaDOS operating 
system uses keymaps to convert this raw code into a 
recognizable character. 

Qualifier indicates which qualifier keys are part of a key sequence. 

As stated before, qualifier keys are keys that modify the 
function of other keys, such as the Control key, the Alt key, 
the Shift key, and so on. 

The raw codes and qualifiers are displayed for reference only. For more 
information about raw codes and qualifiers, refer to the description of 
keyboard . device in Amiga ROM Kernel Reference Manual: Devices, 
3rd Edition (Commodore-Amiga, Inc. 1991). 

After you have displayed a key definition, you can press Return to 
unselect the key, clear the text gadget, and remain in the configuration 
window. You can also select CANCEL or click on the Close gadget to 
exit the configuration window. 


Setting Key Definitions 

By default, the left and right Alt keys are equivalent. For example, Left 
Alt-y performs the same function as Right Alt-y. 

You can choose to make the left Alt and right Alt keys work 
independently. That is, you can choose for the left Alt-y key sequence to 
perform a different function than the right Alt-y sequence. Similarly, you 
can choose for the left and right Shift keys to work independently. To 
make the left and right Alt keys or Shift keys work independently, click 
on the check box next to ALT L = R or shift l = r in the bottom 
right of the configuration window. 

The left and right Amiga keys function independently. You cannot make 
these keys function equivalently. 


► Caution Do not define the Control, right Amiga key, left Amiga key sequence. 
This key combination reboots the machine. ▲ 


To set or change the definition of a key or key sequence, follow these 
steps: 


1. Select the key or key sequence by clicking on the appropriate keys. 
For example, to assign a command to the key sequence Control-C, 
press or click on the Control key and the C key. 

2. Enter the command code in the text gadget. You can type in the 
command code, or you can select the code from the Keys pull-down 
menus. Press Return after entering the command code. For 
example, to assign the CW (Change Window) command to Control-C, 
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type in cw and press Return, or select cw from the Keys 2 menu 
and press Return. 

You can repeat this step as many times as necessary to create 
complex key definitions. 

3. Save the new settings as described in “Saving the New Settings," 
later in this chapter. 


Setting Tab Stops 

By default, tab stops are set at every eighth character, as shown in 
Display 5.1. The tab bar is above the auto-indent bar. 

You can clear all tab stops by clicking on the Clear tabs gadget. To 
set a tab stop, point and click to the place on the tab bar where you want 
to set a tab stop. An uppercase T indicates where a tab stop has been set. 
To delete a single tab stop, point and click at the tab stop. 

After you have set at least one tab stop, you can set a series of tabs at 
equidistant intervals, using the Repeat tabs gadget. When you click on 
the Repeat tabs gadget, the configuration program calculates the 
interval between the last two tab stops you entered, and sets tab stops for 
the remainder of the tab bar using that interval. 

Save the new tab stops as described in “Saving the New Settings," later 
in this chapter. 


Setting Auto-Indent Stops 

Auto-Indent mode is designed to make entering C and C++ code easier. 
For a description of Auto-Indent mode, see the next section “Setting 
Other Options.” 

By default, auto-indent stops are set at every fourth character, as 
shown in Display 5.1. The auto-indent bar is below the tab bar. 

You can clear all auto-indent stops by clicking on the Clear tabs 
gadget. To set an auto-indent stop, point and click to the place on the 
auto-indent bar where you want to set an auto-indent stop. An uppercase 
I indicates where an auto-indent stop has been set. To delete a single 
auto-indent stop, point and click at the auto-indent stop. 

After you have set at least one auto-indent stop, you can set a series of 
indents at equidistant intervals, using the Repeat tabs gadget. When 
you click on the Repeat tabs gadget, the configuration program 
calculates the interval between the last two auto-indent stops you entered 
and sets auto-indent stops for the remainder of the auto-indent bar using 
that interval. 

Save the new auto-indent stops as described in “Saving the New 
Settings,” later in this chapter. 



Setting Other Options 

The Options pull-down menu in the configuration window allows you to 
specify several parameters, including how your input is processed, how 
the Search and Replace commands work, whether the editor saves backup 
files, and so on. The following list describes each of the options in the 
Options pull-down menu. 

If you change any of the options in the Options pull-down menu, you 
must save your changes as described in “Saving the New Settings,” later 
in this chapter. 

Select Font... 

displays a requester that allows you to select a font for se to use. The 
font will be used in the editor window only. You cannot change the 
font in the configuration window. (This option works only under 
AmigaDOS 2.0 or later.) 

Input Processing 

controls the mode in which you enter text into se. You can choose 
from five modes: 

No processing does not convert anything to uppercase or insert 
carriage returns when you reach the right margin. 

You must press Return at the end of each line. 

Asm modes are designed to make entering assembly language code 
easier. In the assembly language modes, the editor 
uses the tab stop settings to determine the start of the 
next field. In Asm mode 1, the editor converts 
anything you enter in field 1 into uppercase. In Asm 
mode 2, the editor also converts anything you enter 
in field 2 into uppercase, and in Asm mode 3, it also 
converts anything you enter in field 3. The editor 
does not convert anything entered on a line after you 
enter a comment character (; or *). 

In any of the assembly language modes: 

□ When you enter a colon (:), space, or tab character 
into the first field, the cursor moves to the second 
field. 

□ When you enter a space or tab character into the 
second field, the cursor moves to the third field. If 
you enter a comment character (; or *), the cursor 
moves to the comment field. 

□ When you enter a comment character into the third 
field, the cursor moves to the comment field. 
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You can enter a comment character into the text 
without causing the cursor to move to the comment 
field by preceding the comment character with a 
backslash (\). 

Autowrap inserts carriage returns into the text when you reach 
the right margin. When the word you are entering 
extends past the right margin, the entire last word is 
moved to the next line. 

The default setting is No processing. This option affects only the 
current window. 

Tab Expansion Method 

specifies whether tab characters are converted to spaces (Expand Tabs 
to Spaces) or left as tab characters (Use TAB Character) . Only the tab 
characters that are entered while Expand Tabs to Spaces is active are 
converted to spaces. Tab characters that already exist are not 
converted when you select Expand Tabs to Spaces. The default setting 
is Use TAB Character. This option affects only the current window. 
Auto-Indent Mode 

is designed to make entering C source code easier. When auto-indent 
mode is on, new lines are indented depending on the following 
criteria: 

□ If the previous line contains an open brace ({), the new line is 
indented one auto-indent stop to the right of the previous line. 

□ Otherwise, if the character is a close brace (}), the new line is 
indented one auto-indent stop to the left of the previous line. 

□ For any other character, the new line is indented to the same 
position as the previous line. 

The default setting is On. This option affects only the current window. 
Column Display 

specifies whether the column number is displayed on the status line. 
The default setting is Off. This option affects all windows. 

Prompt Before Undo 

specifies whether you are asked to confirm each undo command. The 
default setting is On. This option affects all windows. 

Backup File Mode 

specifies how you want the editor to deal with backup files. You can 
specify one of the following: 

□ No Backup File indicates that you do not want the editor to save 
backup copies of each file that you edit. 



□ Place Backup File in Backup Dir specifies that you want the editor 
to save a backup copy of each file that you edit using the same 
filename and extension in a different directory. If you select this 
option, the configuration program asks you for the name of the 
backup directory. 

□ Rename Backup with Backup Ext specifies that you want the editor 
to save a backup copy of each file that you edit using the same 
filename in the same directory as the original file but with a 
different filename extension. If you select this option, the 
configuration program asks you to enter the backup file extension. 

The default setting is No backup file. This option affects all windows. 

Searches Method 

specifies whether the Search and Replace commands should treat the 
search patterns you enter as simple character strings (String Matching) 
or as regular expressions (Use Regular Expressions). If you choose to 
Use Regular Expressions, you should enter search patterns as 
described in the description of the grep utility under “Specifying the 
Pattern” in SAS/C Development System User’s Guide, Volume 2: 
Debugger, Utilities, Assembler, Version 6.0. The default setting is Use 
Regular Expressions. This option affects all windows. 

Case Sensitive Characters 

specifies whether the Search and Replace commands are sensitive to 
case. For example, if this option is On and you specify a search 
pattern in lowercase, the Search command will not locate the same 
pattern in the file if the pattern occurs only in uppercase. The default 
setting is On. This option affects all windows. 


Saving the New Settings 

To save any changes you make using the configuration window, select the 

Use, Save, or Save As options. 

□ Select USE to save the settings to the environment variable 
sc/se.dat in ENV : . Settings saved to ENV : are active until you 
reboot your system. 

□ Select SAVE to save the settings to ENV: and ENVARC : (the equivalent 
of ENV : on disk). Settings saved to ENVARC : are copied to ENV : each 
time you boot your system. 

□ Select the Save As option to save the settings in a file in the current 
directory. The configuration program asks you to enter a filename in 
which to save these settings. 
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If you click on the Close gadget without selecting the Use, Save, or 
Save As option, the new settings are active for your current se session 
only. 


Reusing Saved Settings 

If you use the Save As option to save your configuration settings, you can 
reload these settings later by selecting the Open option from the Project 
menu. The configuration program asks you to specify the filename to 
which you saved the settings. Enter the filename to which you saved the 
settings. To make the settings active, you must click on the SAVE or USE 
gadget. 
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Introduction 

This chapter describes the AREXX interface that is available in the se 
editor. AREXX is a script language commonly used for interprocess 
communication on Amiga hardware. AREXX comes with Version 2.0 of 
the AmigaDOS operating system and can be purchased separately from 
Commodore for Version 1.3. For more information about using AREXX, 
refer to Using the System Software (Commodore-Amiga, Inc. 1990) if you 
are running the AmigaDOS operating system, Version 2.0 or to the 
documentation that comes with the AREXX package if you are running 
AmigaDOS operating system, Version 1.3. 

You can use the AREXX interface to do the following: 

□ execute a series of editor commands that are too complex to assign to a 
keystroke macro 

□ communicate with external programs. 


Executing A Series of Editor Commands 

Sometimes you need to perform an action that is more complex than s e 
can handle with simple keystroke macros. For example, you may need to 
use programming logic such as an if-then-else construction. You can 
create an AREXX macro to perform the action, and then you can assign 
that macro to a key. AREXX macros are files that contain AREXX 
commands. AREXX macros that are to be used with se must have a 
filename with a . s e suffix. 

Tables 7.1 and 7.2 in “AREXX Command Summary," later in this 
chapter describe each of the commands supported by AREXX. As you 
enter AREXX commands, separate each command with a space. You can 
string multiple commands together. 
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If you are passing characters to a command prompt, you must 
terminate the string with a newline character, \n. For example, the 
following command issues the Open Window command, enters foo for 
the filename, and terminates the string with a carriage return: 

/* Issue the Open Window command, */ 

/* type in "foo" for the filename, */ 

/* and terminate data entry with a carriage return. */ 

'OW "foo\n"' 

If you do not specify the \n character, se waits until you type a carriage 
return before proceeding. 

After you have created your macro file, you can assign the macro to a 
key using the SE Configuration Window. To display the SE Configuration 
Window, select the Configuration Window option from the Options pull- 
down menu. Select the key to which you want to assign the macro by 
pressing or clicking on the appropriate key(s). Type the following Rexx 
Macro command in the text gadget and press Return: 

RM "macro-filename" 

The macro-filename is the name of the file containing your macro. If the 
name you specify does not end in . se, the editor appends . se to the 
filename when you invoke the macro, se searches for the macro file in 
the current directory, then in sc : REXX, and finally in REXX: . You can 
specify a fully-qualified pathname for the filename, if necessary. 

For example, suppose you have a series of ft define statements in 
your program such as the following: 

Sdefine FRED 1 
(define BARNEY 4 
(define WILMA 7 
(define BETTY 8 

You want to renumber these statements sequentially: 

(define FRED 1 
(define BARNEY 2 
(define WILMA 3 
(define BETTY 4 
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You could use the following AREXX macro. If invoked from se, this 
macro renumbers the last token on each line of a marked block. 

/* AREXX macro to renumber fdefine statements */ 

/* Tell SE to go to the Block Menu and select End. */ 

/* This effectively moves the cursor to the end of the */ 
/* current marked block. */ 

1 BM "E"’ 

/* Ask SE for 
/* Assign the 
options results 
'GIi' 

end = result 
options 

/* Tell SE to 
/* This moves 
/* block. 

■BM "B"' 

/* Ask SE for 
/* Assign the 
options results 
'GT' 
options 
line = result 

/* Move the cursor to the end of the current line. */ 

'EL' 

/* Back up one word */ 

■P W 


the line number of the current line. */ 

line number to the variable 'end'. */ 


go to the Block Menu and select Beginning. */ 
the cursor to the beginning of the marked */ 


the text of the current line. */ 

text of the line to the variable 'line'. */ 


/* Get the index of the current position in the current */ 
/* line. This index can differ from the current column */ 
/* number if tab characters are present in the line. */ 

/* Assign the index to the variable 'index'. */ 

options results 
'GI' 



/* Read the line and get the number at the end of it. */ 
/* Since the variable 'index' points to the first */ 

/* character of the number, the number consists of */ 

/* everything from the ' index 'th byte of the line to the */ 
/* end of the line. */ 

num = SUBSTR(line, index+1, lengthf line(-index) 

/* 'num' now contains the number at the end of the first */ 
/* line of the marked block. Move down a line, */ 

/* go to the end of the line, back up a word, and ♦/ 

/» delete to the end of the line. The following */ 

/* sequence of four SB commands does this. */ 

'NL EL PH DE' 

/* Loop until the end of the block, replacing the last */ 
/* token on the line with the appropriate number. */ 

do forever 

num = num + 1 /* Increment f define number */ 

num /* Insert the number as text */ 

options results /* Get the current line number */ 

■GL' 

options 

if result >= end then exit(O) /* Exit if past the end */ 
'NL EL PW DE' /* Go to next line and delete last token */ 


Communicating with External Programs 

You can also use AREXX to communicate with other programs from 
within the editor. For example, you may want to send messages to the 
scmsg utility, which allows you to browse your error and warning 
messages. You can also invoke external commands that are unrelated to 
the editor or send AREXX commands to another program that has an 
AREXX port. 

Each program that has an AREXX port names its port so that other 
programs can find it. The name of se’s AREXX port is SC_SE. If more 
than one copy of se is running, only one copy will have an AREXX port. 

When you invoke an AREXX script from within an application, any 
external commands that the script attempts to execute are sent to the 
AREXX port of the application that launched it. Therefore, when se 
launches a script, it should send se commands as external commands. If 
the script wants to communicate with another utility, it should switch to 
that utility’s AREXX port using the AREXX address command. The 
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script can then send commands in whatever format required by that 
utility. To switch back to se, specify the ADDRESS command with 
"SC—SE" as its argument. 

For example, the following se script tells scmsg to go to the next 
error, then gets the information on the error, and positions the cursor on 
the correct line number. 


« REXX script to advance to next error */ 


address "SC-SCMSG" 
'NEXT' 

options results 
'PILE' 

file = result 
'LINE' 

line - result 
options 


/* Switch to the message browser. 1 
/* Go to the next message on the list. ' 
/* Remember the results of commands. 1 
/* Get the filename of the next error. 1 

/* Get the line number. 


address "SC_SE'' 

'OW "'ll file 1 1 '\n n ' 
'LL "'ll line 1 1 '\n" ' 


/* Back to the editor now 
/* Issue Open Window command */ 
/* Issue Go to line command */ 


AREXX Macros Provided with the Compiler 

The SAS/C Development System provides seven AREXX macros that you 
can use from inside of se. The files for these macros are in sc : rexx. 
These macros are as follows: 
amigaguide . se 

displays the help information in the AmigaGuide databases in the 
sc: help directory. By default, this macro is assigned to Alt-D. When 
you invoke this macro, it asks you to enter the name of an 
AmigaGuide database. For a description of each of the AmigaGuide 
databases in the sc: help directory, see Chapter 3, “Getting Help.” 
deletetabs . se 

converts all of the tabs within a marked block to spaces. By default, 
this macro is assigned to the asterisk (*) key in the numeric keypad 
(NUM *). The Tab Expansion Method in the SE Configuration Window 
must be set to Expand Tabs to Spaces for this macro to work 
properly, 
f indsym. se 

looks in the GSTs in memory for the definition of the symbol that is 
under the cursor. If it finds the symbol in a GST, f indsym displays 
the source file in which the symbol is defined. If you do not have any 
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Table 7.1 
AREXX Commands with 
Keystroke Equivalents 


GSTs in memory, this macro does nothing. By default, this macro is 
assigned to the left parenthesis key on the numeric keypad, NUM (. 
indent . se 

indents a marked block three spaces. By default, this macro is assigned 
to the plus (+) key on the numeric keypad (NUM +). 
unindent . se 

unindents a marked block three spaces. By default, this macro is 
assigned to the minus (— ) key on the numeric keypad (NUM — ). 
tolower . se 

converts the current character to lowercase. This macro is not 
assigned to a key by default, but you can assign it to a key using the 
SE Configuration Window, 
toupper . se 

converts the current character to uppercase. This macro is not 
assigned to a key by default, but you can assign it to a key using the 
SE Configuration Window. 

To assign any of these macros to a key, use the Rexx Macro command 
as described in “Executing A Series of Editor Commands,” earlier in this 
chapter. 


AREXX Command Summary 

The following tables list the AREXX commands and their keystroke 
equivalents supported by the editor. 


Command 

Function 

Default Key 
Definition 

A1 

assign macro 1 

Alt-1 

A2 

assign macro 2 

Alt-2 

A3 

assign macro 3 

Alt-3 

A4 

assign macro 4 

Alt-4 

A5 

assign macro 5 

Alt-5 


( continued ) 
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Table 7.1 
(continued) 


Command 

Function 

Default Key 
Definition 

A6 

assign macro 6 

Alt-6 

A7 

assign macro 7 

Alt-7 

A8 

assign macro 8 

Alt-8 

A9 

assign macro 9 

Alt-9 

AO 

assign macro 0 

Alt-0 

BL 

beginning of line 

Num 7 

BM 

go to block menu 

Ctrl-b 

BT 

beginning text 

Ctrl-Num 7 

CO 

invoke scopts utility 

Ctrl-F4 

CS 

change display size 

F9 

CW 

change windows 

Num 5 

DC 

delete character 

Num . 

DE 

delete to end of line 

Ctrl-e 

DL 

delete line 

Ctrl-y 

DW 

delete word 

Ctrl-w 

EL 

end of line 

Num 1 

ES 

se escape character 

Ctrl-\ 

ET 

end text 

Ctrl-Num 1 

FB 

toggle window front to back 

F10 

FD 

go to fork command 

Ctrl-f 

FW 

cycle through open windows 

F6 

GL 

go to locate line command 

Ctrl-1 

HE 

get se help 

FI 

IL 

insert line 

Ctrl-n 

IM 

toggle interlace mode 

Enter 

IN 

toggle insert mode 

Num 0 


(continued) 
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Table 7.1 

( continued ) 


Command Function 
MB mark beginning of block 

MC Match character 

ME mark end of block 

MM go to main se menu 

Ml execute macro 1 

M2 execute macro 2 

M3 execute macro 3 

M4 execute macro 4 

M5 execute macro 5 

M6 execute macro 6 

M7 execute macro 7 

M8 execute macro 8 

M9 execute macro 9 

MO execute macro 10 

NC next character 

NE go to next compiler error 

NL next line 

NP next page 

NW next word 

OM go to configuration window 

OW go to open window command 

PC previous character 

PL previous line 

PM go to project menu 

PP previous page 


Default Key 
Definition 

Ctrl-[ 

Ctrl-5 

Ctrl-] 

F2 

Alt-Fl 

Alt-F2 

Alt-F3 

Alt-F4 

Alt-F5 

Alt-F6 

AU-F7 

Alt-F8 

Alt-F9 

Alt-Fl 0 

Num 6 

F5 

Num 2 
Num 3 
Ctrl-Num 6 
Ctrl-m 
Ctrl-o 
Num 4 
Num 8 
Ctrl-p 
Num 9 


(continued) 
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Table 7.1 
(continued) 


Table 7.2 
AREXX Commands 
without Keystroke 
Equivalents 


Command 

Function 

Default Key 
Definition 

PW 

previous word 

Ctrl-Num 4 

QU 

go to quit se command 

F3 

RK 

restore kill buffer 

Alt-y 

SA 

go to next string match 

Alt-s 

SC 

invoke SAS/C compiler 

F4 

SD 

scroll down 

Ctrl-v 

SE 

go to search command 

Ctrl-s 

SR 

go to search/replace command 

Ctrl-r 

SU 

scroll up 

Ctrl-6 

UN 

go to undo command 

Ctrl-u 


The following AREXX commands do not have keystroke equivalents. 


Command 

Function 

Example 

BP 

build project 

BP 

CR 

carriage control 

CR 

DM 

display message 

DM "message" 

GC 

get column of cursor 

GC 

GE 

get error from last command 

GE 

GI 

get index of cursor 

GI 

GL 

get number of current line 

GL 

GM 

prompt user for input 

GM 

GT 

get text of current line 

GT 

GW 

get word 

GW 

KD 

load key definition file 

KD "env.sc/se.dat" 

RM 

REXX macro 

RM "filename" 
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133 Specifying Linker Options 
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144 Specifying Compiler Options with Overlays 
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Introduction 

This chapter describes how to compile and link your program. It 
describes the sc command and its options, and it describes the slink 
command and its options. 

Compiling Your Program 

As described in Chapter 2, “Using Your SAS/C Development System,” 
you can compile your program from the Shell by entering the sc 
command or from the Workbench screen by double-clicking on the 
Build icon. When you double-click on the Build icon, you are 
indirectly running the s c command as well. 

Entering the sc The sc command has the following format: 

Command sc [ 0 p fi - ons j [fiiename(s)] 

The sc command accepts C source files, C++ source files, assembly 
source files, object files, and link libraries as input files. You can enter 
the filenames anywhere on the sc command line, and you can use 
standard AmigaDOS wildcards to specify filenames. 
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sc determines the input file type by looking at the file extension, sc 
recognizes the following filename extensions: 

. c C source file 

. p C source file (preprocessor output) 

. h C header file (treated as a C source file) 

.cxx C+ + source file 
.cpp C+ + source file 
• cc C+ + source file 
. o Object file 
.lib Link library 

. a Assembler source file 
. asm Assembler source file 
. s Assembler source file 


If you have a file that does not end in one of the recognized extensions, 
you must use the correct sc option to specify the filename: 


csource=fiZename 

specifies a C source file. You can abbreviate this option 


cxxsource=fiJename 

specifies a C+ + source file. 


assembler » filename 

specifies an assembler source file. You can abbreviate this option 
asm. 


object= filename 

specifies an object file. You can abbreviate this option as obj. 
library =filename 

specifies a link library. You can abbreviate this option as lib. 


See “Compiler Option Descriptions,” later in this chapter for a complete 
description of each of these options. 

If you specify an item in the sc command that does not end in a 
recognized extension and is not a valid option, sc appends the . c 
extension and attempts to compile the resultant filename. If sc cannot 
find the file, it reports an error and proceeds to the next file to be 
compiled. 

Note: You can use a plus (+) sign or a comma (,) to separate multiple 
filenames. Therefore, you cannot enter a filename containing a plus sign 
or a comma. 
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To display help information about the sc command, enter sc followed 
by a question mark (?): 


Entering this command displays only the most frequently used sc 
options. 

To display more complete online help, enter the following command: 
amigaguide sc:help/sc. guide 

Compiling and You can compile from Workbench by double-clicking on the Build icon 
Linking from in your project directory. When you double-click on the Build icon, the 
Workbench following steps occur: 

1. The smake utility checks for a makefile called smakef ile, 
makefile, or lmkf ile in the project directory. If one of these 
files exists, then smake builds the default target in that file, just as 
if you had entered smake at the Shell prompt in that directory. 

2. If the directory does not contain a makefile, the smake utility issues 
the following command: 

sc buildproject 
which is equivalent to 

sc |?.c I?. a »?.cxx l?.cpp »?.cc modified link errorrexx 

This command compiles all C, assembler, and C+ + files in the 
project drawer that have been changed since their corresponding 
object files were generated. The buildproject option turns on 
the modified, link, and errorrexx options. These options are 
treated as if you had specified them on the command line, so they 
take precedence over options specified in an scoptions file. See 
the description of the BuildProject compiler option later in this 
chapter for more information. 

If your project drawer contains multiple files, and you want to be able to 
compile only one file by double-clicking on the Build icon, you must 
write your own makefile. You can use the mkmk utility to generate 
makefiles for your projects. For a complete description of mkmk, refer to 
SAS/C Development System User’s Guide, Volume 2. 
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Using Compiler 
Options 


You can specify compiler options in the following ways: 

□ saving the options as project options in an scoptions file (using the 
scopts utility). The sc command looks for this file when you compile 
your program. 

D saving the options as global default options in the variable ENV: sc/ 
scoptions (using the scopts utility). If the sc command cannot 
find a project options file, it looks for global default options. 

□ entering the options in the sc command. Even if you are using an 
scoptions file, you can also specify options on the sc command line. 

When you enter the sc command, the compiler first tries to read options 
from the file scoptions in the current directory. If this file does not 
exist, the compiler looks for options stored in the env : sc/scoptions 
environment variable. Finally, the compiler processes any options you 
enter on the sc command line in the order in which you enter them. If 
an option is specified twice, the compiler uses the setting of that option 
that was specified last. Therefore, you can override the setting of an 
option in the scoptions file or environment variable by specifying that 
option in the sc command, sc reads all options before processing any 
files, so any options specified on the command line after an input file 
name still apply to that file. 

If your current directory contains an scoptions file but you do not 
want the compiler to use the options specified in the file, specify the 
resetoptions option as the first option in the sc command, followed 
by any options you want to set. resetoptions sets all options to their 
default values, resetoptions does not change the contents of the 
scoptions file but does affect the compilation in progress. For more 
information, see the description of the resetoptions option later in 
this section. 

The compiler accepts two types of options: 
switch options 

do not take parameters. All switches have a negative and a positive 
version. To specify the negative version, precede the option with no. 
For example, to use ANSI escape sequences to highlight errors in 
diagnostic output, specify the errorhighlight option. If you do not 
want to highlight errors, specify noerrorhighlight. 
keyword options 

take parameters. Specify the option name, followed by a blank or an 
equal (=) sign and the parameter. For example, to generate debugging 
information for your program, you can specify debug=line or 
debug line. Some keyword options also have a negative form like 
the switch options. For example, if you do not want the compiler to 
generate debugging information, you specify nodebug. 
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The option descriptions that follow give the full name and minimum 
acceptable abbreviation for each option (if the option has an 
abbreviation). You can also use intermediate forms of the options. For 
example, the minimum abbreviation for the absf unctionpointer 
option is afp. Other acceptable abbreviations include absfp, 
absf uncp, and afptr. The compiler options are not case-sensitive. You 
can enter options in upper, lower, or mixed case. 

Summary of Compiler Options 

For each option accepted by the compiler, Table 8.1 shows: 

□ the full name. 

□ the minimum abbreviation. The minimum acceptable abbreviation is 
shown with uppercase letters. For example, the minimum abbreviation 
for the AbsFuncPointer option is afp. 

Note: The compiler options are not case-sensitive. You can enter 
options in upper, lower, or mixed case. 

□ whether the option takes a parameter. An option that takes a 
parameter is listed with an equals (=) sign. 

□ whether the option has a negative form. 

□ the default value, if any. 


Table 8.1 
Summary of Compiler 
Options 

Option Name 

Negative 

Form? 

Default Value 

AbsFuncPointer 

Yes 

noaf p 


ADDSYMbols 

Yes 

noaddsym 


ANSI 

Yes 

noansi 


ARGume nt S I Z e = 

No 

512 


ASseMbler= 

No 



AUTOREGister 

Yes 

autoreg 


BATCH 

Yes 

nobatch 


BSSMEMory= 

No 

any 


BSSNAME= 

Yes 

udata 


BuiLDPRoJect 

No 

( continued ) 
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Table 8.1 
(continued) 


Option Name 

Negative 

Form? 

Default Value 

CHecKABORT 

Yes 

checkabort 

CODE = 

No 

near 

CODEMEMory= 

No 

any 

CODENAME= 

Yes 

text 

CommentNEST 

Yes 

nocnest 

COMMON 

Yes 

nocommon 

CONSTLIBbase 

Yes 

constlib 

COVERage 

Yes 

nocover 

CPU= 

No 

any 

CSouRCe= 

No 


CXXONLY 

Yes 

nocxxonly 

CXXSouRCe= 

No 


DATA= 

No 

near 

DATAMEMory= 

No 

any 

DATANAME= 

Yes 

data 

DeBuG= 

Yes 

nodebug 

DEFine= 

No 


DISASseMble= 

Yes 

nodisasm 

DOLlarOK 

Yes 

nodollarok 

ERRor = 

No 


ERRorCONsole 

Yes 

errcon 

ERRor HIGH light 

Yes 

errhigh 

ERRorLIST 

Yes 

errlist 

ERRorREXX 

Yes 

errrexx 

ERRorSouRCe 

Yes 

errsrc 


(continued) 
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laoie n.i 
( continued ) n . 

Option Name 

Negative 

Form? 

Default Value 

EXTernalDEFs 

Yes 

extdef 

FindSYMbol= 

No 


FROM 

No 


GenProtoDATAi terns 

Yes 

gpdata 

GenProtoEXTerns 

Yes 

gpext 

GenProtoFILE= 

Yes 

f i Jename_protos . h 

GenProtoPARaMeters 

Yes 

nogpparm 

GenPROTOs 

Yes 

nogproto 

GenProtoSTATics 

Yes 

nogpstat 

GenProtoTypeDEFs 

Yes 

gptdef 

Globa lSymbolTable= 

Yes 

nogst 

GSTIMMediate 

Yes 

nogstimm 

ICONS 

Yes 

icons 

IDentif ierLENgth= 

No 

31 

IGNore= 

No 


IncludeDIRectory= 

No 


KeepLINE 

Yes 

nokline 

LIBCODE 

Yes 

nolibcode 

LIBFD= 

Yes 

nolibf d 

LIBPREFIX- 

Yes 

nolibpref ix 

LIBrary= 

No 


LINK 

Yes 

nolink 

LIBREVISION= 

Yes 

nolibrevision 

LIBVERS ION>» 

Yes 

nolibversion 

LINKerDEFine= 

No 


LINKerOPTions= 

Yes 

nolinkopt 


(continued) 
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(continued) n . 

Option Name 

Negative 

Form? 

Default Value 

LINKerWITH= 

No 


LIST 

Yes 

nolist 

ListFILE= 

Yes 

filename . 1st 

ListHEADers 

Yes 

nolhead 

List INCludes 

Yes 

listinc 

ListMACros 

Yes 

nolmac 

ListNARRow 

Yes 

lnarr 

ListSYStem 

Yes 

nolsys 

MakeGlobal Symbol Tab le= 

Yes 


MAP 

Yes 

nomap 

MapFILE= 

Yes 

executable . map 

MapHUNK 

Yes 

nomaphunk 

MapLIB 

Yes 

nomlib 

MapOVerLaY 

Yes 

nomovly 

MapSYMbols 

Yes 

nomsyra 

MapXREFerence 

Yes 

nomxref 

MATH= 

Yes 

nomath 

MAXimumERRors= 

Yes 

50 

MAXimuraWaRNings= 

Yes 

nomaxwrn 

MEMorySIZE= 

No 

large 

MODif ied 

Yes 

nomod 

MultipleCharacterCONSt ants Yes 

nomccons 

Multiple INCludes 

Yes 

mine 

OBJect= 

No 


OBJectLIBrary= 

Yes 


OB JectNAME= 

Yes 

(continued) 
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Table 8.1 
(continued) . 

Option Name 

Negative 

Form? 

Default Value 

OLDPreProcessor 

Yes 

nooldpp 

ONERRor= 

No 

stop 

OPTimize 

Yes 

noopt 

OPT imizer ALIAS 

Yes 

nooptalias 

OPTimizerCOMPlexity= 

Yes 

0 

OPTimizerDEPth= 

Yes 

0 

OPT imizer Global 

Yes 

optgo 

OPTimizerINLine 

Yes 

optinl 

OPTimizer INLOCAL 

Yes 

nooptinlocal 

OPTimizerLOOP 

Yes 

optloop 

OPTimizerPEEPhole 

Yes 

optpeep 

OPT imizer Re cur DEPth= 

Yes 

0 

OPTimizerSIZE 

Yes 

optsize 

OPTimizerTIME 

Yes 

noopttime 

OPTimizerSCHEDule 

Yes 

nooptschedule 

PARaMeters= 

No 

stack 

PRECision= 

No 

mixed 

PreProcess or BUFf er= 

No 

8192 

PreProcess or ONLY 

Yes 

nopponly 

PROFILE 

Yes 

noprofile 

ProgramNAME= 

No 


PUBSCReen= 

No 


RESetOPTions 

No 


SAVEDS 

Yes 

nosaveds 

Short INTegers 

Yes 

nosint 

SmallCODE 

Yes 

noscode 


( continued ) 
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Table 8.1 

( continued ) 


Option Name 

Negative 

Form? 

Default Value 

Small DATA 

Yes 

nosdata 

SouRCeIS= 

Yes 


STacKCHecK 

Yes 

stkchk 

STacKEXTend 

Yes 

nostkext 

STanDardIO 

Yes 

stdio 

STaRTup= 

Yes 

c (for c . o) 

STRICT 

Yes 

nostrict 

STRingsCONst 

Yes 

nostrcons 

STRingMERge 

Yes 

nostrmer 

STRIPDeBuG 

Yes 

nostripdbg 

STRingSECTion= 

No 

default 

STRuctureEQui valence 

Yes 

nostreq 

TO= 

No 


TRIGraph 

Yes 

notrig 

UnderSCORE 

Yes 

nouscore 

UnsignedCHAR 

Yes 

nouchar 

UTILityLIBrary 

Yes 

noutillib 

VERBOSE 

Yes 

noverbose 

VERsion 

Yes 

version 

WaRN= 

No 


WarnVoidRETurn 

Yes 

wvret 

WITH= 

No 


XREFerence 

Yes 

noxref 

Xref erenceHEADers 

Yes 

noxhead 

Xreference SYStem 

Yes 

noxsys 
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Compiler Option Descriptions 

The following pages describe each of the options accepted by the sc 
command. The compiler options are not case-sensitive. You can enter 
options in upper, lower, or mixed case. 


AbsFuncPo inter 

generates 32-bit references to functions when loading function 
pointers. The default value is noabsf uncpointer. The minimum 
acceptable abbreviation is afp. 

If you specify noabsf uncpointer and you take the address of a 
function that is more than 32k away, the linker generates an ALV 
(automatic link vector) jump instruction that allows your code to work. 
However, if you compare the address of the function to a function 
pointer assigned elsewhere, you may get a different value. Specify 
absf uncpointer if your code hunk is larger than 32K or in 
multiple code hunks and you compare function pointers. Specifying 
absf uncpointer may increase the size of your executable. 


AddSymbols 

tells the linker to add symbol information to the executable module. 
The default value is noaddsymbols. The minimum acceptable 
abbreviation is adds yin. 

This option is automatically enabled if you specify the debug 
option. This option is ignored if you do not specify the link option. 


enforces the strictest interpretation of the ANSI C standard. The 
default value is noansi. 

Specifying ansi does the following: 

□ suppresses warning number 95, promotes warning 193 to an error, 
and produces many additional warning messages. For a complete 
list of messages that are enabled by the ansi option, see “Enabling 
Suppressed Messages,” in Appendix 2. 

□ prevents the definition of certain preprocessor symbols. For a list of 
these symbols, see “Using Preprocessor Symbols Defined by the 
Compiler,” later in this chapter. 

□ disallows the initialization of variables declared with the extern 
keyword. For example, the following statement is not allowed: 


extern int i = 7; 



□ disables the far, near, and chip keywords. However, far, 

near, and chip are still valid. 

To be completely ANSI-compliant (that is, if you require a pure 
ANSI namespace), you should also define the preprocessor symbol 

STRICT ANSI to 1 before including any header files. For more 

information about _STRICT_ANSI, refer to Chapter 7, “C Library 
Reference,” in SAS/C Development System Library Reference. If you 
require support for ANSI trigraphs, specify the trigraph option 
also. 

For more information about improving the portability of your code, 
see Chapter 13, “Writing Portable C Code." 

This option is ignored when compiling C++ files. 


Argument Size=n 

sets the size of the maximum argument to a C preprocessor macro. 
The minimum acceptable abbreviation is argsiz. This option does 
not have a negative form. The default value is 512. However, the 
memorysize option sets the arguments ize (and other internal 
limits) to different default values if you do not specify 
argumentsize. 

See the description of the memorysize option for more 
information. 

This option is ignored when compiling C++ files. 


As s embl er =f\lename(s) 

specifies assembly-language files that are to be assembled and, if you 
specify the link option, linked into the program. The minimum 
acceptable abbreviation is asm. This option does not have a negative 
form. 

You can use AmigaDOS wildcard characters to specify filenames. To 
specify several filenames or wildcard patterns, separate each filename 
with a plus (+) sign or a comma (,). You can specify the assembler 
option as many times as necessary. 

If you are assembling a disassembly that was generated with the 
disassemble compiler option, specify the underscore compiler 
option also. (If you assemble a disassembly by calling the assembler 
directly, specify the -u assembler option.) 

See also the descriptions of the csource, object, and library 
options. 
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AutoRegister 

enables automatic register selection by the code generator. The default 
value is autoregister. The minimum acceptable abbreviation is 
autoreg. 

If you specify autoregister, the compiler attempts to add 
register variables to the variables that have already been chosen by 
the global optimizer or declared with the register keyword. 


Batch 

tells the linker not to prompt for definitions of undefined symbols. The 
default value is nobatch. This option is ignored if you do not specify 
the link option. See also the description of the batch linker option. 


BSSMeraory=type 

specifies the type of memory into which uninitialized external data 
items should be loaded. You can specify any, chip, or fast for type. 
You can abbreviate these values as a, c, or f. The default value is 
any. This option does not have a negative form. 

This option affects code generated by both the compiler and the 
assembler. See also the descriptions of the datamem and codemem 
options. 


BSSName=name 

names the uninitialized data section. The default value is udata. You 
can specify bssname=none or nobssnarae if you want an unnamed 
BSS section. The linker automatically merges all sections with the 
same name. See also the descriptions of the codename and 
datanarae options. See Chapter 12, “How the Compiler Works” for 
information on data and code sections. 


BuildPro ject 

rebuilds the current project. The minimum acceptable abbreviation is 
bldpr j. This option does not have a negative form. 

This option compiles and links the source files specified on the 
command line or in the scoptions file. This option turns on the 
modified, link, and errorrexx options. 

Entering sc buildproj from the Shell is equivalent to entering: 


sc |?.c I?. a |?.cxx f?.cpp |?.cc modified errorrexx link 



Entering sc filename buildproj is equivalent to entering: 
sc filename modified errorrexx link 


CheckAbort 

enables Control-C in your program. The default value is 
checkabort. The minimum acceptable abbreviation is chkabort. 
This option is ignored if you do not specify the link option. 

If you compile with checkabort, your program will check for 
Control-C interrupts whenever I/O is performed. If you specify 
nocheckabort, the compiler passes the following option to the 
linker: 

define 3 chkabort=3 dummy 

dummy is a function provided in the link libraries that simply returns. 

Specifying nocheckabort makes all calls to the chkabort 

function do nothing, thereby removing Control-C checking. 

Do not specify nocheckabort if you are redefining the library 
function chkabort in your own code. 


C o d e = reference-type 

specifies whether you want 16-bit or 32-bit references to functions not 
declared in the current file. You can specify near or n for 16-bit 
references or far or f for 32-bit references. The default value is 
near. This option does not have a negative form. 

Most programs do not need this option even if they are very large, 
because the linker creates a jump instruction (an ALV) for any 
references to functions that are out of range. See also the description 
of the data option. 


CodeMemory = type 

specifies the type of memory into which code should be loaded. You 
can specify any, chip, or fast. You can abbreviate these values as 
a, c, or f . The default value is any. This option does not have a 
negative form. 

This option affects code generated by both the compiler and the 
assembler. See also the descriptions of the bssmem and datamem 
options. 
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CodeName=name 

names the code section. The default value is text. You can specify 
co<3ename=none or nocodename if you want an unnamed code 
section. The linker automatically merges all sections with the same 
name. See also the descriptions of the bssname and dataname 
options. See Chapter 12, “How the Compiler Works” for information 
on data and code sections. 


CommentNest 

allows nested comments. The default value is noconunentnest. The 
minimum acceptable abbreviation is cnest. 

Nested comments occur when one comment is totally contained 
inside another. The ANSI Standard prohibits nested comments, so in 
ANSI-compliant code, the first comment end sequence (*/) terminates 
both comments. For example, the statement below generates an error 
with noconunentnest, but compiles successfully with 
commentnest. 

/* i = i+1 ; /* This is a comment */ */ 

The statement below compiles successfully with noconunentnest, but 
generates an error with commentnest. 

/* i = i+1; /* This is a comment */ 


Common 

tells the compiler to use the relaxed reference-definition model for 
external data. If you specify no common, the compiler uses the strict 
reference-definition model. The default value is nocommon. 

The section “Using Relaxed Ref-Def Model External Data” in 
Chapter 11, “Using SAS/C Extensions to the C and C+ + Languages," 
describes relaxed and strict reference-definition models. 


ConstLibBase 

tells the compiler that library base pointers are set once then remain 
constant throughout your entire program. The default value is 
constlibbase. The minimum acceptable abbreviation is 
constlib. 

If you change the value of your library bases after setting them, you 
should specify the noconstlibbase option. Specifying 
constlibbase allows the compiler to prevent extra register loading 



when making a series of calls to library functions through an external 
variable containing the library base. 


Coverage 

tells the compiler to generate code to collect coverage analysis 
information. The default value is nocover. The minimum acceptable 
abbreviation is cover. 

Coverage analysis information allows you to determine which lines 
of your program have been executed by your test cases. For more 
information, refer to the description of the cover utility in SAS/C 
Development System User’s Guide, Volume 2: Debugger, Utilities, 
Assembler. 

Unlike Version 6.0, the necessary coverage initialization and 
termination routines are in the standard link library. You do not have 
to link with a special object file. 


CPU -processor 

generates code specific to the specified processor. You can specify any, 
a, or 68000 to generate code for any processor. You can also specify 
68010, 68020, 68030, or 6 8 0 4 0 to generate code for a specific 
processor. The default value is any. This option does not have a 
negative form. 

This option defines one or more preprocessor symbols. See the 
section “Using Preprocessor Symbols Defined by the Compiler,” later 
in this chapter for a list of those symbols. 

This option affects code generated by both the compiler and the 
assembler. 


CSouzce-ftlename 

specifies C source files that are to be compiled and, if you specify the 
link option, linked into the program. The minimum acceptable 
abbreviation is csrc. This option does not have a negative form. 

You can use AmigaDOS wildcard characters to specify filenames. To 
specify several filenames or wildcard patterns, separate each filename 
with a plus (+) sign or a comma (,). You can specify the csource 
option as many times as necessary. See also the descriptions of the 
assembler, cxxsource, object, and library options. 


CxxOnly 

tells sc to translate the C+ + source files into C source files without 
compiling them. The default value is cxxonly. 
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The filename for the generated C file is 
root-filename, .c 

root-filename is the filename of the C+ + file. For example, if your 
C+ + file is named f oo . cxx, the C source file generated is named 
foo. .c. If you do not specify the cxxonly option, the . .c file is 
created, compiled, and then deleted. 


CxxSourc e=filename 

specifies C+ + source files that are to be compiled and, if you specify 
the link option, linked into the program. The ihinimum acceptable 
abbreviation is cxxsrc. This option does not have a negative form. 

You can use AmigaDOS wildcard characters to specify filenames. To 
specify several filenames or wildcard patterns, separate each filename 
with a plus (+) sign or a comma (,). You can specify the cxxsource 
option as many times as necessary. See also the descriptions of the 
assembler, csource, object, and library options. 


D a t a = reference-type 

specifies whether you want the compiler to generate 16-bit or 32-bit 
references to external and static data items. You can specify any of the 
following: 
near or n 

tells the compiler to use 16-bit references. If you specify near, all 

data not declared with the far or chip keyword are placed 

into the near data section. The default value is near, 
far or f 

tells the compiler to use 32-bit references. Register A4 is still 
reserved to point to the near data section so that you can mix code 
compiled with data=near and data=far. 
faronly or fo 

tells the compiler that your program never uses near data. If you 
specify faronly, the compiler generates 32-bit references and 
may use register A4 as an additional register variable. If you 
compile with the data = far only option, and you declare data 

with the near keyword, the compiler displays the warning 

message 194: 

too much local data for NEAR reference, 
some changed to FAR 



If your entire project is in one source file or is compiled with 
data = f aronly, you can ignore this warning unless you get an 
error later in the compilation or link, 
auto or a 

indicates that the first 32k of external data should generate 16-bit 
references and the remaining external data should generate 32-bit 
references. If your module has more than 32k of external data, the 
compiler displays the warning message 194: 

too much local data for NEAR reference, 
some changed to FAR 

If your entire project is in one source file or is compiled with 
data = f aronly, you can ignore this warning unless you get an 
error later in the compilation or link. 

You should not use data=auto if you have multiple modules 
that share data. 

This option does not have a negative form. 

You can override this option on individual data items by using the 

near, far, or chip keywords. near forces the 

compiler to generate a 16-bit reference, and far forces the 

compiler to generate a 32-bit reference chip forces the compiler 

to place the data item into chip memory. For more information, refer 
to the section “Using Special Keywords” in Chapter 11, “Using SAS/C 
Extensions to the C and C++ Languages.” 

See also the description of the code option. 


Da taMemory = type 

specifies the type of memory into which initialized static or external 
data should be loaded. You can specify any, chip, or fast. You can 
abbreviate these values as a, c, or f . The default value is any. This 
option does not have a negative form. 

This option affects code generated by both the compiler and the 
assembler. See also the descriptions of the bssmem and codemem 
options. 


DataName=name 

names the initialized data section. The default value is data. You can 
specify dataname=none or nodataname if you want an unnamed 
data section. 

The linker automatically merges all sections with the same name. 

See also the descriptions of the bssname and codename options. See 
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Chapter 12, “How the Compiler Works” for information on data and 
code sections. 


Debug =level 

sets the debugging level of the compiler. If you do not want the 
compiler to generate debugging information, specify nodebug. The 
default value is nodebug. The minimum acceptable abbreviation is 
dbg. 

To generate debugging information, specify debug =level, where 
level is one of the following: 

line or 1 

produces line number information only, 
symbol or s 

produces line number information, information on automatic and 
formal variables, and information on external and static symbols 
that are referenced in the module being compiled, 
symbolflush or sf 

produces the same information as symbol, and flushes any non- 
register variables being held in registers to memory at each line 
boundary to allow the debugger to accurately display their values 
in C source mode, 
full or f 

produces the same information as symbol. However, 
debug=full produces information on all symbols whether or not 
the module references the symbol, 
fullf lush or f f 

produces the same information as full, and flushes any non- 
register variables being held in registers to memory at each line 
boundary to allow the debugger to accurately display their values 
in C source mode. 

Any debug option except nodebug adds the -d assembler option to 
any assembled files to force debugging line number information on 
assembler output. Also, if you specify the link option and any debug 
option except nodebug, the addsym option is passed to the linker. 


Def ineI=]symbol[=value] 

defines the specified preprocessor symbol to be used by the compiler. 
This option works as if you defined the symbol with a # define 
statement. The minimum acceptable abbreviation is def. This option 
does not have a negative form. 
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Do not enter a space between the symbol name and the following 
equal sign. If the value contains a space, enclose the entire argument 
in double quotes (“). As with all other compiler options, the equal sign 
between the define option and the symbol name is optional, so both 
of the following examples are acceptable: 

define foo=bar 
define=foo=bar 

You can specify the define option as many times as necessary. 

Any symbols defined with the define option are defined in the 
assembler as well. 

Note: The define compiler option does not affect the linker. Do 
not confuse this option with the define linker option. 


DisAssemble=/i/ename 

tells the compiler to disassemble the code as it is generated and to 
send the disassembly to the file you specify. The default value is 
nodisassemble. The minimum acceptable abbreviation is disasm. 
To send the disassembly to standard output, use disasm=*. 


DollarOK 

allows dollar signs ($) as valid characters in identifiers in both C and 
C++ programs. The default value is nodollarok because the 
ANSI C Standard does not allow dollar signs in identifiers. The 
minimum acceptable abbreviation is do 1 ok. 


Erroran 

tells the compiler to treat the specified message as an error. You can 
specify all or a to promote all enabled warnings to errors, or you 
can specify one or more message numbers to promote only those 
messages. The minimum acceptable abbreviation is err. This option 
does not have a negative form. 

To specify several message numbers, separate each number with a 
plus ( + ) sign or a comma (,). You can specify the error option as 
many times as necessary. See also the descriptions of the warn and 
ignore options. 


ErrorConsole 

enables printing of diagnostics to the console (stdout). The default 
value is errconsole. The minimum acceptable abbreviation is 
errcon. 
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Err or High light 

highlights the token that caused the error using ANSI escape 
sequences in diagnostic output that is sent to the console. The default 
value is errorhighlight. The minimum acceptable abbreviation is 
errhigh. 

This option is ignored when compiling C+ + files. 


ErrorList 

prints diagnostic messages to the listing file. The default value is 
errorlist. The minimum acceptable abbreviation is errlist. This 
option is ignored if you do not specify the list option. 


ErrorRexx 

sends diagnostic messages from the compiler to the scrasg utility. The 
default value is noerrorrexx. The minimum acceptable abbreviation 
is errrexx. 

For more information, refer to the description of the scrasg utility 
in Chapter 10, “Utility Reference,” of SAS/C Development System 
User's Guide, Volume 2. 


ErrorSource 

prints lines from the C source file with the diagnostic messages that 
are sent to the console. The default value is errorsource. The 
minimum acceptable abbreviation is errsrc. 


ExternalDef s 

treats all external definitions as definitions. The default value is 
externaldefs. The minimum acceptable abbreviation is extdef. 

If you specify noexternaldef s, all external definitions are 
treated as external declarations. This action has the same effect as if 
you had declared each variable with the extern keyword. For 
example, int i is treated as extern int i, and it would need to 
be defined in a file compiled without noexternaldef s. 


FindSymbo 1 =symbol-name 

tells the compiler to print a warning message each time the specified 
symbol is defined. The minimum abbreviation is f syra. This option 
does not have a negative form. You can specify the f indsymbol 
option as many times as necessary. 

If you specify the f indsymbol option, a message is produced for 
any definition of the symbol, including ((define statements, structure 
and union declarations, prototypes, and extern, static, and local 



variable definitions. Use the f sym option to quickly determine where 
a given preprocessor symbol or prototype is coming from. 

This option is ignored when compiling C+ + files. 


is included only for compatibility with the slink command. The 
compiler ignores this option. This option does not have a negative 
form. 


GenProtoDatal terns 

generates external declarations for variables defined in the source files 
that are not defined as static. The minimum abbreviation is 
gpdata. The default value is gpdata. This option is ignored if you 
do not specify the genprotos option. 


GenProtoExterns 

generates prototypes for externally-known routines. The default value 
is genprotoexterns. The minimum acceptable abbreviation is 
gpext. 

This option is ignored if you do not specify the genprotos option. 


GenProtoFil e=filename 

specifies the name of the file in which to place the generated 
prototypes. The default value is filename_protos .h. The 
minimum acceptable abbreviation is gpf ile. 

This option is ignored if you do not specify the genprotos option. 


GenProtoParameters 

generates prototypes using the PARMS macro. The default value is 

nogenprotoparameters. The minimum acceptable abbreviation is 
gpparm. 

This option allows your C code to compile successfully on compilers 
that support prototypes and on those that do not. On ANSI compilers, 

the PARMS macro expands to the parameter list for the function, 

thereby creating a prototype. On non-ANSI compilers, the parms 

macro expands to an open-close parentheses pair, which declares the 
function’s return type without defining a prototype. This option is 
ignored if you do not specify the genprotos option. 


GenProtos 

generates prototypes and data declarations instead of compiling your 
file. The default value is nogenprotos. The minimum acceptable 
abbreviation is gproto. 
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This option defines the preprocessor symbol —GENPROTO. If you 
specify a filename with the genprotof ile option, the prototypes are 
written to the specified file. Otherwise, the prototypes are written to 
the file filename_protos .h. 

While generating prototypes, the compiler suppresses most warnings 
automatically, because many of the warnings may be due to incorrect 
or missing prototypes. The compiler also checks all ff include 
statements as they are reached. If your file # includes the same 
prototype file that is being generated, the compiler skips that 
((include statement. This feature allows you to use this option to 
maintain declarations for all externally-known symbols in each C 
source file and regenerate the declarations as the files change. 

To set up your project so that you can use this option to maintain 
prototype files, do the following: 

1. Create a header file that contains # include statements for each 
of the files in your project, as follows: 

((include "file/_protos.h" 

((include "file2- protos.h" 


((include "filen_protos.h" 

2. Include this header file in each file in your project. 

3. Compile your entire project with the genproto option. 

As each . c file is compiled, the compiler creates the corresponding 
_protos .h file. The compiler suppresses the header file not 
found warnings that would normally be produced. 

This option is ignored when compiling C++ files. 


GenProtoStatics 

generates prototypes for static routines. The default value is 
nogenprotostatics. The minimum acceptable abbreviation is 
gpstat. 

This option is ignored if you do not specify the genprotos option. 


GenProtoTypedef s 

tells the compiler to use typedefs instead of resolved types when 
generating prototypes for any functions using typedefs for parameters 
or return values. The default value is genprototypedef s. The 
minimum acceptable abbreviation is gptdef . 



This option is ignored if you do not specify the genprotos option. 


Globa lSymbolTable=gst 

tells the compiler to use the specified GST (Global Symbol Table). The 
default value is noglobalsymboltable. The minimum acceptable 
abbreviation is gst. 

The GST must have been created using the 
makeglobalsymboltable option during a previous compilation. 
The gst option is ignored if you specify the 
makeglobalsymboltable option. Therefore, you can enter the 
makeglobalsymboltable in the sc command even if your 
scoptions file contains the gst option. 

This option defines the preprocessor symbol _GST. 

This option is ignored when compiling C++ files. 


GST =gst-filename 

is a synonym for the GlobalSymbolTable option. 


GSTImmediate 

is included for compatibility with projects using precompiled header 
files as implemented in Version 5 of the compiler. This option makes 
the contents of the GST you specify with the gst option immediately 
available to the program. The default value is nogst immediate. The 
minimum acceptable abbreviation is gstimm. 

Normally, symbols defined in a specific header file in the GST are 
available to your program only after you have included the header file 
with a ft include statement. This option makes the contents of the 
GST you specif)' with the gst option immediately available to the 
program, even if your program does not contain # include 
statements for the header file. With Version 5 precompiled header 
files, all symbols in the precompiled header files were available to 
your program even if your program did not contain # include 
statements for the header file. 


Icons 

tells the compiler to create icons for files that it creates, including 
listing files, preprocessor output files, prototype files, and object files. 
The default value is icon. 

If you specify icons, then each time the compiler generates a file, 
it looks in the drawer sc : icons for an icon named 
def —extension, where extension is the filename extension of 
the file it created. If the compiler finds an icon file appropriate to the 
file extension, it copies the icon to the directory in which the file was 
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created. If the compiler cannot find sc:icons or cannot find an icon 
with the appropriate extension, it does not create an icon. If you 
specify noicons and link, the noicons option is also passed to the 
linker. For more information, see the section “Using Icons” in 
Chapter 2, “Using Your SAS/C Development System." 


I dent if ierLength=n 

specifies the maximum number of significant characters in an 
identifier. The default value is 3 1 . The minimum acceptable 
abbreviation is idlen. This option does not have a negative form. 

Identifiers longer than n are truncated without warning. Identifiers 
longer than n bytes that differ after the first n bytes are treated as 
identical. 

This option is ignored when compiling C+ + files. 


Ignore=n 

tells the compiler to ignore the specified warning message. The 
minimum acceptable abbreviation is ign. This option does not have a 
negative form. 

You cannot ignore error messages. You can specify all or a to 
ignore all warning messages, or you can specify one or more message 
numbers to ignore only those messages. To specify several message 
numbers, separate each number with a plus (+) sign or a comma (,). 
You can specify the ignore option as many times as necessary. 

See also the descriptions of the error and warn options. 


lncludeDirectory=directo/y 

adds a directory to the list of directories to search for include files. 

The default list is the current directory and include : . The minimum 
acceptable abbreviation is idir. This option does not have a negative 
form. You can specify the incdirectory option as many times as 
necessary. 

Any directories you specify with includedirectory are also 
passed to the assembler as header file search directories. 


KeepLine 

generates # line directives in the preprocessor output file that 
correspond to the lines in the original source files. The default value is 
nokeepline. The minimum abbreviation is kline. 

This option allows you to compile the preprocessed source and get 
error and warning messages that refer you to the correct line in the 
nonpreprocessed version of the file. 

This option is ignored if you do not specify the pponly option. 



LibCode 

tells the compiler that the compiled code will be linked into a shared 
library. The default value is nolibcode. 

Any functions compiled with libcode and either the saveds 

keyword or the saveds option load their near data section from a 
point relative to the library base register A6 instead of from an 
absolute address, libcode also guarantees that the current library 
base will be in register A6 whenever A6 is referenced or an internal 
call is made. 

This option is for use when creating a shared library. Do not use 
this option when creating an object module for a normal executable. 


hibFU= filename 

specifies the name of a function description (. fd) file. The compiler 
passes this option to the linker. This option does not have a negative 
form and is ignored if you do not specify the link option. 

This option is for use when creating shared libraries. Do not use 
this option when creating an object module for a normal executable. 


L i bPre f i x ^prefix 

specifies the prefix that you want added to the functions listed in the 
function description (. fd) file. The compiler passes this option to the 
linker. This option does not have a negative form and is ignored if you 
do not specify the link option. 

This option is for use when creating shared libraries. Do not use 
this option when creating an object module for a normal executable. 


Libr ary =link-library-filename(s) 

specifies the link libraries that are to be passed to the linker. The 
minimum acceptable abbreviation is lib. This option does not have a 
negative form. 

You can use AmigaDOS wildcard characters to specify filenames. To 
specify several filenames or wildcard patterns, separate each filename 
with a plus ( + ) sign or a comma (,). You can specify the library 
option as many times as necessary. Any libraries you specify are 
passed to the linker before the SAS/C libraries. This option is ignored 
if you do not specify the link option. 

See also the description of the csource, cxxsource, object, 
and asm options. 


LibRevision=n 

specifies a minor revision number for the shared library that you are 
creating. The compiler passes this option to the linker. This option 
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does not have a negative form and is ignored if you do not specify the 
link option. 

This option is for use when creating a shared library. Do not use 
this option when creating an object module for a normal executable. 


LibVersion=n 

sets the version number of the shared library that you are creating. 
The compiler passes this option to the linker. This option does not 
have a negative form and is ignored if you do not specify the link 
option. 

This option is for use when creating a shared library. Do not use 
this option when creating an object module for a normal executable. 


Link 

tells the compiler to invoke the linker to produce a final executable 
module. The default value is nolink. 

If you do not specify link, the compiler ignores any object files and 
link libraries that you specify. 

The options passed to the linker are placed into the file 
program. Ink, and the linker is invoked using this file as a with 
file. To see which linker options were generated, look at the . Ink file 
after sc runs the linker. 


LinkerDef ine [ =]symbo/[=value] 

defines a symbol to be used in the linking process. You can specify as 
many LinkerDef ine options as you like. The compiler passes each 
LinkerDef ine option to the linker as the define option. The 
minimum acceptable abbreviation is linkdef. This option does not 
have a negative form and is ignored if you do not specify the link 
option. 


Linker Opt ions =opt/onfcl 

passes the provided parameter to the linker’s command line. The 
default value is nolinkeroptions. The minimum acceptable 
abbreviation is linkopt. 

If you want to specify more than one option, or if the option you 
want to specify contains a blank, surround the entire option string 
with double quotes (“), as in the following example: 

sc "linkeroptions=buf size 10000 maxhunk 64000" link myprog.c 

Any options specified in the options string are passed to the linker 
after any compiler options that are identified as valid only if you 



specify link. Therefore, the linkeroptions values override the 
values passed by the sc options. 

This option is ignored if you do not specify the link option. 


LinkerWith=fi/ename 

specifies the name of a file containing linker options. You can specify 
as many LinkerWith options as necessary. The compiler passes each 
LinkerWith option to the linker as the with option. The minimum 
acceptable abbreviation is linkwith. This option does not have a 
negative form and is ignored if you do not specify the link option. 


tells the compiler or assembler to produce a listing file. The default 
value is nolist. 

The compiler writes the output to the filename you specify with the 
listfile option. If you do not specify an output filename, the 
compiler uses the name of the first source file you specify but with the 
extension .1st. 

This option is ignored when compiling C+ + files. 


ListFile=fiJename 

names the listing and/or cross reference file. The default filename is 
the same filename as the source file but with the extension .1st. The 
minimum acceptable abbreviation is If ile. 

This option is ignored if you do not specify the list or 
xreference options. 


ListHeaders 

tells the compiler or assembler to include user header files in the 
listing. The default value is listheaders. The minimum acceptable 
abbreviation is lhead. 

This option is ignored if you do not specify the list option. 


Listlncludes 

lists the names of all included . h files in the listing file. The default 
value is listincludes. The minimum acceptable abbreviation is 
line. 

This option is useful for determining: 

□ .h file dependencies for smake 

□ the exact path of each . h file used 

□ exactly which . h files are included by other . h files. 
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The hierarchy of files is indicated by indention levels; a file included 
by another file is indented one level deeper than the parent file. This 
option is ignored if you do not specify the list option. 


ListMacros 

tells the compiler or assembler to expand macros in the listing. The 
default value is nolistmacros. The minimum acceptable 
abbreviation is lmac. 

This option is ignored if you do not specify the list option. 


ListNarrow 

tells the compiler or assembler to produce a narrow listing (less than 
80 columns wide). The default value is listnarrow. The minimum 
acceptable abbreviation is lnarr. 

This option is ignored if you do not specify the list option. 


ListSystem 

tells the compiler to include system header files in the listing. The 
default value is nolistsystem. The minimum acceptable 
abbreviation is lsys. 

This option is ignored if you do not specify the list option. 


MakeGlobalSymbolTable=gst-fiZename 

creates a GST (Global Symbol Table). The minimum acceptable 
abbreviation is mgs t. 

If you specify the gst and makegst options, the gst option is 
ignored. Therefore, you can enter the makegst in the sc command 
even if your scoptions file contains the gst option. This option 
automatically enables the nomultiple includes and 
noexternaldef s options. For more information on creating and 
using GSTs, refer to SAS/C Development System Library Reference. 

This option defines the preprocessor symbol _MGST. 

This option is ignored when compiling C++ files. 


produces a map of the executable module. The default value is nomap. 
This option is ignored if you do not specify the link option. 


MapF ile “filename 

names the map file. The default value is executable. map. The 
minimum acceptable abbreviation is mf ile. 

This option is ignored if you do not specify the link and map 
options. 



MapHunk 

maps all output hunks by size and originating function. The default 
value is raaphunk. The minimum acceptable abbreviation is mhunk. 

This option is ignored if you do not specify the link and map 
options. 


MapLib 

generates a list of hunks by library symbol in the map. The default 
value is nomaplib. The minimum acceptable abbreviation is mlib. 

This option is ignored if you do not specify the link and map 
options. 


MapOverlay 

includes a list of hunks in each overlay in the map. The default value 
is nomapoverlay. The minimum acceptable abbreviation is movly. 

This option is ignored if you do not specify the link and map 
options. 


HapSymbols 

includes a list of defined symbols and the location at which they are 
defined. The default value is nomapsymbols. The minimum 
acceptable abbreviation is msym. 

This option is ignored if you do not specify the link and map 
options. 


MapXref erence 

writes a symbol cross-reference to the map file that lists each symbol 
definition and the places each symbol is used. The default value is 
nomapxref erence. The minimum acceptable abbreviation is 
mxref . 

This option can generate a lot of output, but it is useful when you 
are trying to track down where an unresolved symbol is referenced. 
This option is ignored if you do not specify the link and map 
options. 


Math=type 

chooses a format for floating-point math and, if you also specify the 
link option, links with the appropriate math library. The default 
value is nomath. 
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You can specify one of the following as the type: 
standard or s 

links with the library scm. lib, scms .lib or scmnb. lib, 
depending on the value of the data and short int options. The 
math format is IEEE, 
ffp or f 

generates code to call the FFP shared library provided by 
Commodore. The math format is FFP. This option links with 
scmf fp. lib. This option is not supported for C++ files. 

68881, 68882, or 8 

generates inline code for the 68881 and 68882 coprocessors. If 
you specify one of these coprocessor options, your program will not 
run if a coprocessor is not available, coprocessor is a synonym 
for these options. The math format is IEEE. This option links with 
scra88 1 .lib. 
ieee or i 

generates code to call the IEEE shared library provided by 
Commodore. The math format is IEEE. This option links with 
scmieee . lib. 

Some math options define preprocessor symbols. See the section 
“Using Preprocessor Symbols Defined by the Compiler,” later in this 
chapter, for a list of those symbols. 

For additional information about compiling and linking with math 
libraries, refer to Chapter 3, “Using the SAS/C Libraries,” in SAS/C 
Development System Library Reference. 


MaxiraumErrors=n 

sets the limit on the number of errors for a single compilation. The 
default value is 50. The minimum acceptable abbreviation is max err. 

If a single compilation generates more than n errors, the compiler 
aborts the compilation, nomax err removes any limits. 


MaximumWarnings=n 

sets the limit on the number of warnings for a single compilation. The 
default value is nomaxwrn. The minimum acceptable abbreviation is 
maxwrn. 

If a single compilation generates more than n warnings, the 
compiler aborts the compilation, nomaxwrn removes any limits. 



MemorySize=size 

tells the compiler approximately how much memory you have on your 
system. You can specify one of the following: 

□ tiny or t 

□ small or s 

□ medium or m 

□ large or 1 

□ huge or h 

The default value is large. The minimum acceptable abbreviation is 
merasize. This option does not have a negative form. 

Larger sizes allow sc to compile more complex programs and to 
compile faster. Smaller sizes allow sc to continue to work under low- 
memory conditions. If the compiler runs out of memory during a 
compilation, it displays the message ***Freeing Resources, 
attempts to free up memory, and automatically drops to a lower 
memorysize value. 

If you specify link and either raemorysize=tiny or 
memorysize = small, the compiler passes the buf size = 4096 
option to the linker. 

memorysize affects how and where the compiler stores any 
debugging information. If the compiler begins to run out of memory, it 
starts writing debugging information to a disk file. This file is referred 
to as a debug side file. 

memorysize also affects the disposition and buffering of the 
compiler intermediate file. This option tells the compiler how much 
initial memory space to reserve for the intermediate information. For 
large and huge, the intermediate file is kept totally in memory 
(when the memory is available), which is much faster than writing it 
to disk. At smaller values, the intermediate file is written to disk, but 
the memorysize value affects the amount that is buffered. 

In addition, if you do not specify the preprocessorbuf f er 
(ppbuf) and/or argumentsize (argsize) options, the 
memorysize option sets these values for you. If you specify the 
preprocessorbuf fer and/or argumentsize options, the values 
you specify override the values set by memorysize. 

The following table lists the default values for argumentsize and 
preprocessorbuf fer by memorysize. It also lists the buffer size 
of the compiler intermediate file. 
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Intermediate Debug Side 


memsize 

argsize 

ppbuf 

File Buffer 

File Buffer 

tiny 

127 

1024 

1024 

2K 

small 

255 

2048 

4096 

8K 

medium 

511 

4096 

8192 

32K 

large 

1023 

8192 

no limit 

64K 

huge 

4800 

16384 

no limit 

128K 


See also the descriptions of the preprocessorbuf f er and 
argumentsize options. 

Modified 

tells the compiler to process only files that are out of date with respect 
to their output files. The default value is nomodi fied. The minimum 
acceptable abbreviation is mod. 

This option is useful if you are compiling several files with a single 
s c command and only some of the files need to be recompiled. This 
option also works when you are generating prototypes or preprocessor 
output. If you also specify the link option, all object files are 
included in the link, even if their source files were not recompiled. 


MultipleCharacterConstants 

allows up to four bytes to appear within single quotes as a character 
constant. This option is included only for compatibility with previous 
releases of the compiler, and its use is not recommended. The 
minimum acceptable abbreviation is me cons. The default value is 
noraccons. 

If you specify mccons, a single constant of type int is generated. 

If fewer than four bytes are provided, they are padded on the left with 
zeroes, as in the following example: 

{include <stdio.h> 

void main(void) 

I 

long 1 = 'abed' ; 

long m = '\x01\x02\x03' ; 

printf ("l-0x*081x, m-0x*081x\n" , 1, m); 



This example program prints the following: 
1=0x61626364, m=0x00010203 
This option is ignored when compiling C+ + files. 


Multiplelncludes 

tells the compiler to include header files that are included more than 
once. The default value ismultipleincludes. The minimum 
acceptable abbreviation is mine. 

This behavior is required by the ANSI Standard. However, many 
projects do not need this behavior, and specifying nomine can save 
compilation time. 

Specifying nomultipleincludes has no effect when compiling 
C++ files. 


Object =filename(s) 

lists the object files that are to be linked into the program. The 
minimum acceptable abbreviation is obj. This option does not have a 
negative form. 

The object files must have been created during a previous 
compilation. Do not specify object files that will be created by the 
same sc command in which you specify the object option. You can 
use AmigaDOS wildcard characters to specify filenames. To specify 
several filenames or wildcard patterns, separate each filename with a 
plus (+) sign or a comma (,). You can specify the object option as 
many times as necessary. 

This option is ignored if you do not specify the link option. See 
also the descriptions of the csource, library, and assembler 
options. 


Ob jectLibrary “link-library-name 

specifies that any resulting object files are to be placed in the named 
link library. The minimum acceptable abbreviation is obj lib. 

Do not specify this option if you also specify the link option. 


0 b j e c t N ame = file-or-directory-name 

specifies the name of the file or directory to hold compiler and 
assembler output (including temporary . . c files). The minimum 
acceptable abbreviation is obj name. 

If you are compiling or assembling only one source file, you can use 
this option to specify the file where you want the compiler or 
assembler output. If you are compiling or assembling more than one 
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file, you can use this option to specify a directory where you want the 
output, and s c uses the same filename as the source file but replaces 
the extension with . o. The directory name must end with a forward 
slash (/) or a colon (:). If you do not use the objectnarae option, sc 
uses the same filename with the extension of . o, but it places the files 
in the same directory as the source file. The C+ + translator will 
generate the temporary . c file into the same path as specified by the 
ObjectName option. 


OldPreprocessor 

is provided for compatibility with pre-ANSI style preprocessors. The 
default value is nooldpreprocessor. The minimum acceptable 
abbreviation is oldpp. 

The oldpp option does the following: 

□ allows old-style token pasting using comments 

□ substitutes values for parameters specified as quoted strings in 
macro definitions. 

For example, suppose you have the following program: 

I define FOO(bar) "bar" 

void main(void) 

( 

printf("Xs\n", F00( test ) ) ; 

1 


If you compile this program with oldpp, the program prints test. If 
you compile this program with nooldpp, the program prints bar. To 
make this program work with the ANSI features and the nooldpp 
option, substitute the following for the ft define: 

((define FOO(bar) Ibar 

As an additional example, suppose you have the following program: 

((define FOO(bar) foo_/**/bar 

void main(void) 

1 


int foo_test; 
int foo_xxx; 
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FOO(test) * 10; 

FOO(xxx) = 20; 

printfCJtd Xd\n", foo_test, foo_xxx); 

) 

If you compile this program with oldpp, the #def ine concatenates 
the text of the argument after the string f oo_ and the program prints 
10 20. If you compile this program with no oldpp, the program 
produces a compilation error. To make this program work with the 
ANSI features and the nooldpp option, substitute the following for 
the ((define: 

ddefine FOO(bar) foo_|Jbar 
This option is ignored when compiling C+ + files. 


OnError=x 

tells sc what action to take if a source file generates an error. The 
minimum acceptable abbreviation is oner r. This option does not have 
a negative form. 

You can specify one of the following: 
stop or s 

tells sc not to process any more source files. The default value is 
stop. 

continue or c 

tells s c to process the next source file. 

If you specify the link option, but your program generates errors, 
your program is not linked even if you specify onerr=continue. 


Optimize 

enables the global optimizer (unless you specify nooptglobal) and 
peephole optimizer (unless you specify nooptpeep). The default value 
is nooptimize. The minimum acceptable abbreviation is opt. 


OptimizerAlias 

disables type-based aliasing assumptions in the optimizer. The default 
value is nooptimizeralias. The minimum acceptable abbreviation 
is optalias. 

If you specify optiraizeralias, the global optimizer uses worst- 
case aliasing. Specifying optiraizeralias can significantly reduce 
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the amount of optimization that can be performed. This option is 
ignored if you do not specify the optimize and optglobal options. 


OptimizerComplexity=n 

defines the maximum complexity level of functions to be automatically 
inlined. The default value is 0. The minimum acceptable abbreviation 
is optcomp. 

The parameter n represents the relative complexity of the function 
to be inlined and is a count of the number of discrete operations in 
the function. Try different values for this number until you get the 
results you want. The higher the number, the more functions you can 
inline, but the size of your code will grow significantly as well. 

If you specify nooptcomp, no complexity-based inlining occurs. 
This option is ignored if you do not specify the optimize, 
optglobal, and optimizerinline options. 


OptimizerDepth=n 

defines the maximum nesting depth of automatically inlined functions. 
The default value is 0. The minimum acceptable abbreviation is 
optdep. 

This option is ignored if you do not specify the optimize, 
optglobal, and optimizerinline. 


OptimizerGlobal 

enables the global optimizer. The default value is 
optimizer global. The minimum abbreviation is optgo. This 
option is ignored if you do not specify the optimize option. 


Optimizerinline 

allows inlining of functions, including functions defined with the 

inline keyword. The default value is optimizerinline. The 

minimum acceptable abbreviation is opt ini. 

This option is ignored if you do not specify the optimize and 
optglobal options. 

If you specify nooptinline, the optinlocal, optdepth, 
optcomplexity, and optrdepth options are ignored. 


OptimizerlnLocal 

inlines single-use static functions. The default value is 
nooptimizer inlocal. The minimum acceptable abbreviation is 
optinlocal. 

This option is ignored if you do not specify the optimize, 
optglobal, and nooptimizerinline options. 



OptimizerLoop 

enables loop optimizations. The default value is optimizerloop. 
The minimum acceptable abbreviation is opt loop. 

This option is ignored if you do not specify the optimize and 
optglobal options. 


Optimizer Peephole 

enables the peephole optimizer. The default value is 
optimizerpeephole. The minimum acceptable abbreviation is 
optpeep. 

This option is ignored if you do not specify the optimize option. 


Optimizer Recur Depth=n 

defines the maximum depth of recursion of automatically inlined 
functions. The default value is 0. The minimum acceptable 
abbreviation is optrdep. 

This option is ignored if you do not specify the optimize, 
optglobal, and optinline options. 


OptimizerSize 

generates smaller code, possibly increasing execution time. The default 
value is nooptsize. The minimum acceptable abbreviation is 
optsize. 

This option is ignored if you do not specify the optimize and 
optglobal options. Do not specify both the optimizersize and 
optimizertime options. 


Optimizer Time 

generates code that will run faster but may be larger. The default 
value is nooptimizertime. The minimum acceptable abbreviation 
is opttime. 

This option is ignored if you do not specify the optimize and 
optglobal options. Do not specify both the optimizersize and 
optimizertime options. 


Optimizer Schedule 

runs the instruction scheduler. The default value is nooptschedule. 
The minimum acceptable abbreviation is optsched. 

The scheduler reorders instructions to make them run faster on 
higher-order processors, like the 68040 and 68882, without 
sacrificing the ability to run on lower-order processors. Running the 
scheduler may take additional compilation time. 
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This option is ignored if you do not specify the opt peep and 
optimize options. 


P a r ame t e r s = method 

indicates how parameters should be passed. The minimum acceptable 
abbreviation is parm. This option does not have a negative form. 

You can specify one of the following: 
stack or s 

indicates parameters should be passed on the stack. The default 
value is stack, 
register or r 

indicates parameters should be passed in registers, 
both or b 

generates a combination prolog that allows parameters to be passed 
on the stack or in registers. 

If your program has prototypes for all routines, you should probably 
use parameters = register for increased efficiency. If you are 
placing code into a link library, specify parms=both so that your 
library functions accept registerized parameters and parameters that 
are passed on the stack. 

If you write a function that has the same name as a SAS/C library 

function, you need to add the regargs keyword to your function 

or compile with the parms=both or parms = register option. For 
example, you may want to replace the SAS/C library function malloc 
with your own version of malloc. If you compile with the 
parms = stack option or define your version of malloc with the 

stdargs keyword, then two versions of malloc are linked into 

your executable. If you use other SAS/C library functions that call 
malloc, these functions use the version of malloc in the SAS/C 
libraries. However, your functions that call malloc use your version 
of malloc. To make sure that all calls to malloc are using your 
version of malloc (including calls from library routines), define your 

version with regargs or compile with the parms=both or 

parms = register option. 

With C+ + functions, only functions with "C" linkage obey the 
value you specify with the parameters option. All C+ + functions 
behave as if you specified parameters = register unless you 
explicitly declare them with stdargs or asm. 

For information about passing parameters between C language 
functions and assembly language functions, refer to Chapter 11, 

“Using Assembly Language with the C and C+ + Languages,” in 
SAS/C Development System User’s Guide, Volume 2. 



Precision* precision 

specifies the size of floating-point variables. You can specify double 
or mixed. The default value is mixed. The minimum acceptable 
abbreviation is prec. This option does not have a negative form. 

If you specify double, data declared as float are treated as if 
they were declared as double. If you specify mixed, data declared as 
float and data declared as double are different sizes. 


PreprocessorBuf f er=n 

sets the maximum number of bytes to which a macro can be expanded 
by the preprocessor. The default value is 8192 unless set differently 
by the memorysize option. The minimum acceptable abbreviation is 
ppbuf. This option does not have a negative form. 

If a macro expands to greater than n bytes, the compiler issues an 
error message and aborts the compilation. See the description of the 
memorysize option for more information. 

This option is ignored when compiling C++ files. 


Preprocess or Only 

tells the compiler to run only the preprocessor on the source files. The 
default value is nopreprocessoronly. The minimum acceptable 
abbreviation is pponly. 

If you specify a filename with the objectname option, the 
compiler writes the output to the file you specify. If you do not specify 
an output filename, the compiler writes the output to the same 
filename as the source file but with the extension . p. 

This option defines the preprocessor symbol —PPONLY. 


Profile 

generates code at the entry and exit of each function that calls library 
functions —PROLOG and —EPILOG, respectively. —PROLOG and 
—EPILOG note the time the function was entered and exited and pass 
this information to sprof , which produces a report telling you how 
much time was spent in each function. The default value is 
noprofile. This option defines the preprocessor symbol —PROFILE. 


ProgramNarae=output-module-name 

specifies the name of the executable module. The default value is the 
root name of the first source file specified in the s c command. The 
minimum acceptable abbreviation is pname. This option does not have 
a negative form. 

This option is ignored if you do not specify the link option. 
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PubScreen=name 

specifies the name of the public screen to use when sc invokes 
scmsg. The minimum abbreviation is pubscr. This option does not 
have a negative form. 

The pubscreen option overrides any public screen specification in 
the scmsg options file. The scopts utility uses any pubscreen 
specification set in the scoptions file or on the command line. 


ResetOptions 

resets all options to their default values. The minimum acceptable 
abbreviation is resopt. This option does not have a negative form. 

If you specify this option as the first option in the sc command, it 
resets any option specified in the scoptions file. If you specify this 
option after other options or filenames in the sc command, it resets 
the options preceding it, including the filenames. 


Saveds 

generates code as if you had defined all functions in the source files 

with the saveds keyword. The default value is nosaveds. 

The saveds keyword loads the near data pointer in register A4 

at each function entry point. You should specify this option if you are 
compiling code that is used as an interrupt routine, called with the 
AddTask function, used in a shared library, or called from another 
process. This option does not work if your code is linked with the 
cres.o or catchres.o startup modules. 


Shortlntegers 

enables 16-bit integers. The default value is noshortintegers. The 
minimum acceptable abbreviation is sint. 

If you specify shortintegers, types int and short are the 
same size. If you specify noshortintegers, types int and long 
are the same size. If you are running the assembler, this option 
defines the symbol short int. This option also defines the 
preprocessor symbol —SHORTINT. 

This option is illegal when compiling C+ + files. 


SmallCode 

tells the linker to merge all code hunks into a single hunk. The 
default value is nosmallcode. The minimum acceptable abbreviation 
is scode. 

This option is ignored if you do not specify the link option. See 
also the description of the small code linker option. 



SmallData 

tells the linker to merge all data and bss sections into a single hunk. 
The default value is nosmalldata. The minimum acceptable 
abbreviation is sdata. 

This option is ignored if you do not specify the link option. See 
also the description of the sraalldata linker option. 


Sour cels “filename 

sets the name of the C source file in the object file and in debugging 
information to the specified value instead of the actual name of the C 
source file. The minimum acceptable abbreviation is srcis. 

You can use this option if you plan to rename or move the source 
file before using the debugger to debug your program. If you are 
compiling or assembling exactly one source file, sourceis can 
specify the name of the file to be placed into the debug information. If 
you are compiling or assembling multiple files, sourceis should 
specify a directory name (ending with a forward slash or colon). 


StackCheck 

generates stack overflow checking code at each function entry. The 
default value is stackcheck. The minimum acceptable abbreviation 
is stkchk. 

When a program is about to run out of stack space, the program 
displays a requestor and terminates gracefully. For a complete 
description of the stackcheck option, see Chapter 11, “Using SAS/C 
Extensions to the C and C+ + Languages.” 


StackExtend 

generates stack extension code at each function entry. The default 
value is nostackext. The minimum acceptable abbreviation is 
stkext. 

When a program runs out of space in the current stack, a new stack 
is allocated, and your program continues to run. For a complete 
description of the stackext option, see Chapter 11, “Using SAS/C 
Extensions to the C and C+ + Languages.” 


StandardIO 

is included for compatibility with previous releases of the compiler. 
This option has no effect. The libraries in Version 6.50 and later 
automatically initialize standard I/O if it is used. 
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StartUp=modu/e-name 

specifies which startup module to use. The default value is c (for 
c.o). The minimum acceptable abbreviation is strt. 

If the module name that you specify does not contain a colon (:), 
forward slash (/), or period (.), the compiler adds lib: to the 
beginning and . o to the end of the name you specify. If you do not 
want to compile with a startup module, specify nostartup. This 
option is ignored if you do not specify the link option. 

If you specify libinit or libinitr, then the compiler also uses 
lib : 1 ibent . o before the specified startup file and tells the linker to 
generate a shared library. If you specify devinit or devinitr, 
then the compiler also uses LIB : devent . o before the specified 
startup file and tells the linker to generate a device. 


Strict 

enables a large number of diagnostics dealing with portability and 
questionable situations in your code. The default value is nostrict. 

Specifying strict may produce warning messages for situations 
that are not a problem. 

For more information on improving the portability of your code, see 
Chapter 13, “Writing Portable C Code.” 

This option is ignored when compiling C+ + files. 


StringsConst 

tells the compiler to consider all string constants to be of type 
const char *. The default value is nostringsconst. The 
minimum acceptable abbreviation is strcons. 

If you do not specify stringsconst, the compiler considers string 
constants to be of type char *. If you specify stringsconst, 
passing a string constant to a function that expects the type char * 
generates a warning message indicating that the function may modify 
the string constant. 

This option is ignored when compiling C+ + files. 


StringMerge 

merges all identical string constants in the C source file and changes 
the default value of the stringsection option to 
stringsection=code. The default value is nostr ingmerge. The 
minimum acceptable abbreviation is strmer. 

If you specify str ingmerge, the compiler examines each string 
constant defined in the code and checks for duplicates. If the compiler 
finds a duplicate string constant, it forces both references to refer to 
the same memory location. 



If you specify stringmergo and you modify a string constant, the 
constant is modified in all locations. For example, suppose you have 
the following program: 

linclude <stdio.h> 

void modifyme(char *); 

void main(void) 

( 

modifymel "Hello, World!\n"); 
printf ("Hello, World!\n"); 

) 


void modifyme(char *msg) 

( 

strcpy(msg, "Foobar\n"(; 

1 


If you compile the program with stringmerge, the program prints 
Foobar. If you compile the program with nostringmerge, the 
program prints Hello, World!. 


StripDebug 

strips all debugging information from the final executable. The default 
value is nostr ipdebug. The minimum acceptable abbreviation is 
stripdbg. 

This option is ignored if you do not specify the link option. 


StringSection-section 

indicates where to place strings, data declared static const, and 
initializers for automatic structures, unions, and arrays. The minimum 
acceptable abbreviation is strsect. This option does not have a 
negative form. 

You can specify one of the following: 
default 

stores data according to the following rules: 

1. If you specify strmerge, the code section is used. 

2. If you specify data = far or data=near, the named section 
is used. 

3. Otherwise, the near section is used. 
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The default value is default, 
near or n 

stores the data in the near data section, 
far or f 

stores the data in the far data section, 
code or c 

stores the data in the code section. 

If you specify a value other than default, the strings and static 
const data are placed in the specified section regardless of whether 
you specify strmerge or data. 

This option allows you to merge strings and place them in the far 
section for residentable programs or shared libraries. Since the strings 
are read-only, they can be placed safely into far data; placing them in 
the far section frees up more near data space for your read/ write 
external variables. 

The stringsection option has two useful side effects. Because 
some data are placed in the code section: 

□ Less data needs to be placed into the near data section. If you have 
more than 64k of data, you can use the stringsection option to 
try to reduce the amount of data and allow your code to continue to 
use the near data model. 

□ The string constants are addressed relative to the PC (program 
counter) instead of the beginning of the near data section. 

Therefore, it is possible to generate programs with no near or far 
data. 

For more information on the code and near data sections, see 
Chapter 12, “How the Compiler Works” 


StructureEqui valence 

tells the compiler not to issue messages if a pointer to one structure 
type is passed to a function when the function expects a pointer to a 
different type, if the type passed is equivalent to the type expected. 
The default value is nostructureequivalence. The minimum 
acceptable abbreviation is streq. 

For information on using equivalent structures, see Chapter 11, 
“Using SAS/C Extensions to the C and C+ + Languages." 

This option is ignored when compiling C+ + files. 



To=filename 

is included only for compatibility with the slink command, to is a 
synonym for the programname option. This option does not have a 
negative form. 


Trigraph 

specifies whether to use ANSI trigraphs in your programs. The default 
value is notrigraph. The minimum acceptable abbreviation is 
trig. 

Specifying trigraph slows down the compiler. 


Underscore 

adds underscores to the beginning of all external names defined in any 
assembler source files assembled. The default value is 
nounderscore. The minimum acceptable abbreviation is uscore. 

The underscores allow you to refer to these names in assembly 
language in the same way you do in C and C+ + source files. This 
option is ignored if you do not specify any assembly-language files in 
the sc command. For more information, refer to Chapter 11, “Using 
Assembly Language with the C and C+ + Languages,” in SAS/C 
Development System User's Guide, Volume 2. 


UnsignedChar 

makes the default type of char variables unsigned instead of 
signed. The default value is nouns ignedchar. The minimum 
acceptable abbreviation is uchar. This option defines the preprocessor 
symbol —UNSCHAR. 


UtilityLibrary 

generates inline calls to the AmigaDOS 2.0 ROM-resident library 
utility . library to do integer multiplication and division instead 
of calling SAS/C library functions to do these operations. The default 
value is noutilitylibrary. The minimum acceptable abbreviation 
is utillib. 

Specifying utilitylibrary makes your executable smaller and 
faster by taking advantage of 68020 instructions if they are available, 
but your program runs only under AmigaDOS 2.0. If you link using 
the sc command and the utilitylibrary and link options, sc 
defines all the SAS/C library integer conversion stub routines to stubs 
that call utility, library. This action prevents the SAS/C library 
routines that use integer conversion routines from using the SAS/C 
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versions of the routines. If you link using the slinkcommand, you 
need to specify the following define linker options: 

define CXM33= UCXM33 

define CXD33= — UCXD33 

define CXH22= UCXH22 

define CXD22= UCXD22 

These define options are in the file LlB:utillib.with, so you 
can link with the following command: 

slink with LIB:utillib.with options 


Verbose 

displays messages about each stage of compiling and linking. The 
default value is noverbose. 


Version 

prints a banner containing the compiler version number and a 
copyright message. The default value is version. The minimum 
acceptable abbreviation is ver. 


Warn =n 

enables the specified compiler warning message. The minimum 
acceptable abbreviation is wrn. This option does not have a negative 
form. 

You can specify all or a to enable all warning messages, or you 
can specify one or more message numbers to enable only those 
messages. To specify several message numbers, separate each number 
with a plus ( + ) sign or a comma (,). You can specify the warn option 
as many times as necessary. 

See also the description of the error and ignore options. 


WarnVoidReturn 

issues a warning message if a function declared as returning an 
integer actually returns no value. The default value is 
warnvoidreturn. The minimum acceptable abbreviation is wvret. 

The nowarnvoidreturn option suppresses the return value 
mismatch warning message for functions declared as returning an 
integer, but that do not contain a return statement or that do not 
include an expression in the return statement. 

This option is ignored when compiling C+ + files. 
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w ith = filename 

specifies the name of a file containing additional options. The 
additional options are read immediately, as if they were specified in 
the sc command at the position occupied by the with option. Options 
specified after the with option may override options specified in the 
with file. This option does not have a negative form. You can specify 
the with option as many times as necessary. 

Note: Do not confuse this option with the with linker option. 


XREF 

is a synonym for the xref erence option. 


XRef erence 

produces a cross-reference. The default value is noxref erence. The 
minimum acceptable abbreviation is xref. 

The compiler writes the output to the filename you specify with the 
listfile option. If you do not specify an output filename, the 
compiler uses the name of the first source file you specify but with the 
extension . 1 st. 

This option is ignored when compiling C++ files. 


XRef erenceHeaders 

generates a cross-reference of user header files. The default value is 
xref erenceheaders. The minimum acceptable abbreviation is 
xhead. 

This option is ignored if you do not specify the xref erence 
option. 


XRef erenceSystem 

includes symbols defined in system header files in the cross-reference. 
The default value is xref erencesystem. The minimum acceptable 
abbreviation is xsys. 

This option is ignored if you do not specify the xref erence 
option. 


Using 
Preprocessor 
Symbols Defined 
by the Compiler 


The compiler automatically defines certain preprocessor symbols each 
time you run the compiler, and it defines other symbols only when you 
use specific compiler options. 

Table 8.2 lists each of the symbols that the compiler automatically 
defines each time you run the compiler. 
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Table 8.2 
Preprocessor Symbols 
Defined by the 
Compiler 


Table 8.3 
Preprocessor Symbols 
Defined by Compiler 
Options 


Symbol 

Value 

—AMIGA 

1 

—M68000 

1 

SASC 

1 

SASC—60 

1 

SASC—6 5 0 

1 

VERSION 

6 

REVISION 

50 

STDC 

1 

FILE 

current filename 

LINE 

current line number 

FUNC 

current function for C programs; 
null string for C+ + programs 

DATE 

current date 

TIME 

current time 


Table 8.3 lists each of these preprocessor symbols defined when you 
use specific compiler options and the options that ((define these 
symbols. These symbols are defined to 1 when you specify the 
corresponding option. For example, if you specify the noansi option, the 
AMIGA symbol is defined as follows: 

{define AMIGA 1 

Symbol 

Compiler Options 

AMIGA 

noansi 

LPTR 

noansi and noshortint 

SPTR 

noansi and shortint 

LATTICE 

noansi 

LATTICE 50 

noansi 

-M68010 

cpu=68010 | 68020 | 68030 | 68040 


( continued) 
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Table 8.3 

(continued) 


Symbol 

Compiler Options 

-M68020 

cpu = 68020 | 68030 | 68040 

—M68030 

cpu=68030 | 68040 

—M68040 

cpu=68040 

-M68881 

math=6888 1 

_FFP 

math=FFP 

-IEEE 

raath=IEEE 

-DEBUG 

debug=any-value 

_ SHORTINT 

shortint 

-UNSCHAR 

unschar 

—OPT 

optimize 

_ OPTINLINE 

optinline 

_ PPONLY 

pponly 

—PROFILE 

profile 

_ GENPROTO 

genproto 

-MGST 

makegst 

—GST 

gst 


Linking Your Program 

As described in Chapter 2, “Using Your SAS/C Development System,” 
you can link your program from the Shell by specifying the link option 
in the sc command or from the Workbench screen by specifying the 
link option in your scoptions file and double-clicking on the Build 
icon. 

You can also compile and link your program in separate steps. If you 
do not specify the link option on the sc command line, you need to call 
the linker, slink, to link your program. Use the slink command only 
if you are limited by the sc command. For the majority of programs, 
linking with the sc command is much simpler and easier than linking 
with the slink command. If you link using the sc command, you can 
specify linker options with the linker opt compiler option. 

Entering The After you have compiled your program, you can enter the slink 
slink Command command as follows: 

slink [ startup-module]object-files [options] 
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You must specify at least one object file. You probably also need to 
specify a startup module and one or more libraries. If you specify one 
filename on the slink command line, slink will use that filename 
(without the file extension) as the executable module name. If you specify 
more than one filename, slink assumes that the first filename is the 
name of a startup module and will use the second filename as the 
executable filename. If necessary, you can use the to option to specify 
the name of the executable module. 


Specifying Linker 
Options 


The slink command accepts the following options: 
addsyra 

generates hunk_syrabol records for all extemally-visible symbols in 
each object file and library module whether or not the object file was 
compiled with the debug compiler option. This option gives 
CodeProbe the location, but not the size or type, of any externally 
visible symbols in your program. 


batch 

sets the value of all undefined data symbols to 0 and all undefined 

code symbols to stub. Normally, slink asks you to enter a 

value for each undefined symbol. However, if you specify batch, 
slink does not prompt you to enter values for undefined symbols. 

If an undefined function is called, the library function stub 

( stub to the linker) is called instead. The library’s version of 

stub displays a requester telling you that an undefined routine 

was called and allows you to choose whether to abort or continue. 


bufsize n 

sets the I/O buffer size for slink. By default, slink buffers all 
object modules. Buffering requires more memory but reduces the time 
required to link your program. If you run out of memory while 
linking, try linking with bufsize 4096. This specification tells 
slink to buffer only one file at a time and to use a buffer size of 
4096 bytes, 
chip 

specifies that all hunks are to be placed in chip memory regardless of 
the input object hunk specifications. However, if you specify fast or 
chip for the datamem, codemem, or bssmem compiler options, that 
value overrides this option. 

The chip option is provided for compatibility with previous 
versions of the linker. It is recommended that you use the datamem, 
codemem, and bssmem compiler options instead, 
define symboI[=va/ue] 

defines a symbol to be used in the linking process. You can use this 
option with the prelink option to force specific routines from the 



libraries to be linked into your program even though your program 
does not contain any references to the routines. 

Remember that linker symbols have an extra underscore added to 
the beginning of the symbol name. To refer to a function f oo using 
the define option, you must specify _foo. To refer to registerized 
functions, add an at (@) sign to the beginning of the symbol name, as 
in afoo. 

Note: Do not confuse this option with the define compiler 
option, 
fancy 

enters control characters to highlight and bold headings in the map 
file. The option is on by default. To disable the use of these control 
characters, specify the plain option, fancy is ignored if you do not 
specify the map option, 
fast 

specifies that all hunks are to be placed in fast or expansion memory 
regardless of the input object hunk specifications. However, if you 
specify fast or chip for the datamem, codemem, or bssmem 
compiler options, that value overrides this option. 

The fast option is provided for compatibility with previous 
versions of the linker. It is recommended that you use the datamem, 
codemem, and bssmem compiler options instead, 
faster 

is included only for compatibility with the Commodore linker, a link, 
from object-filename(s) 

identifies the object files that are the primary input to the linker. You 
can specify the from option as many times as necessary in the slink 
command. If you specify the object files as the first items in the 
slink command, you do not need to use the from option. The root 
option is a synonym for this option. 

The object files are copied to the root of the object module. You 
must specify at least one object file in the slink command, 
fwidth n 

specifies the filename width, in columns, in the map file. The default 
value is 16. This option is ignored if you do not specify the map 
option, 
height n 

specifies the total number of lines on a page in a map file. If you 
specify 0, the linker does not add form feed characters to the file. The 
default value is 55. This option is ignored if you do not specify the 
map option. 



Specifying Linker Options 135 


hwidth n 

specifies the hunk name field width, in columns, in the map file. The 
default value is 8. This option is ignored if you do not specify the map 
option, 
indent n 

specifies the number of columns to indent on a line in the map file. 
The map file is indented n columns from the value specified by the 
width option. The default value is 0. This option is ignored if you do 
not specify the map option, 
libfd filename 

specifies the name of a function description (. fd) file. Use this option 
only if you are building a shared library. 

For information on creating shared libraries, refer to SAS/C 
Development System Library Reference. 
libprefix prefix 

specifies the prefix you want added to the functions listed in the 
function description ( . f d) file. The default prefix is an underscore (_). 
Use this option only if you are building a shared library. The 
libprefix option allows the library to call entry points within itself, 
without using the library base. 

Make sure that the function declarations in your source code match 
the full name, including any specified prefix. For example, suppose 
your library has a function called myf unc. Your . f d file contains the 
following line: 

myfunc(a) (dO) 

If you specify a prefix of _LIB, you should declare the function in 
your source code as LlBmyfunc, as shown in the following example: 

fpragma mylibbase myfunc 1e 001 

asm LlBmyfunc (register — d int a) 

( 

return a+1 ; 

) 


void test(void) 

I 

LIBmyfunc( 1); /* Call myfunc directly. 

myfunc(2); /* Call myfunc through the library base. 


) 



For information on creating shared libraries, refer to SAS/C 
Development System Library Reference. 
library link-library-filename(s) 

specifies the library files that you want the linker to search for 
modules referenced in your code. Only referenced modules from 
library files are included in the final executable module. You can 
abbreviate this option as lib. 
librevision n 

specifies a minor revision number of the library you are creating. If 
you do not specify a revision number, it defaults to 0. Use this option 
only if you are building a shared library. 

For information on creating shared libraries, refer to SAS/C 
Development System Library Reference. 
libversion n 

sets the version number of the library you are creating. You can set 
the version number to any number from 0 to 255. The default is 1. 
Use this option only if you are building a shared library. 

For information on creating shared libraries, refer to SAS/C 
Development System Library Reference. 
map [mapfile [map-option[,]map-opfion...]] 

tells slink to create a map file. The map file contains information on 
the size and location of all hunks and the value of all symbols. 

If you do not specify a mapfile, the linker writes the map 
information to the file executable . map. If you specify a mapfile, 
you can also specify the following map file options: 
f lists the hunks in each file 
h lists hunks by size and originating function 
1 lists hunks by library function 
o lists hunks in each overlay 
s lists where symbols are defined 

x creates a symbol cross-reference that lists where the symbols are 
defined and their definition, 
maxhunk n 

limits to n bytes the size of the hunks that slink creates when 
merging hunks. By default, there is no limit on hunk size, 
noalvs 

issues warning messages if slink generates an automatic link vector 
(ALV) instruction to resolve 16-bit program counter-relative 
references. Using this option stops slink from creating a non- 
relocatable module from what was intended to be relocatable code. 
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nodebug 

is included for compatibility with previous releases of the linker. Use 
the stripdebug option instead. You can abbreviate this option as 
nd. 

noicons 

prevents the linker from creating icons for the files that it creates, 
onedata 

tells the linker to merge all data, bss, and chip sections. Merging 
hunks may decrease the time required to load your program but may 
produce larger hunks that are difficult to scatter load, 
overlay 

identifies the start of an overlay tree. You should enter the overlay 
option and the list of files in each overlay in a with file, as follows: 

overlay 

overlay- l-filemme(s) 

*overlay-2-filename(s) 


It 

You must terminate the overlay tree with a line consisting of a single 
pound (#) sign. For more information, see “ Using Overlays,” later in 
this chapter. See also the description of the with option, 
ovlymgr filename 

tells slink to use the filename you specify as the overlay manager 
instead of the default filename, ovs . o, which is contained in the 
libraries. The file you specify should consist of a single code hunk 
named ntryhunk and define the global symbol _ovlyMgr. 
prelink 

tells slink to produce an object module with symbol references and 
definitions still intact. You can then link with this object module to 
produce an executable module. This option is useful if you are 
developing a large application and changing only a single source 
module. Do not specify this option if you are using overlays, 
plain 

turns off the fancy option. This option tells the linker not to enter 
control characters for highlighting and bold in the map file. This 
option is ignored if you do not specify the map option. 



pwidth n 

specifies the width of program unit name field in the map file. The 
default value is 8. This option is ignored if you do not specify the map 
option, 
quiet 

suppresses all linker messages except error messages, 
root object-fUename(s) 

specifies the object files that are the primary input to the linker. These 
object files are always copied to the root of the object module. You 
must specify at least one object file for the root. If the primary input 
files appear as the first option to slink, then the root keyword is 
optional and may be omitted. The from option is a synonym for 
root. You can specify the root option more than once. The files you 
specify with root are added to the list of files to be linked, 
swidth n 

specifies the width of the symbol names field in the map file. Default 
value is 8. This option is ignored if you do not specify the map option, 
smallcode 

tells the linker to merge all code hunks. You can abbreviate this 
option as sc. 
smalldata 

tells the linker to merge all data and bss sections. Merging hunks 
may decrease the time required to load your program, but may 
produce larger hunks that are difficult to scatter load. You can 
abbreviate this option as sd. The smalldata option does not merge 
chip data with non-chip data. To merge chip data also, specify the 
onedata option instead, 
stripdebug 

suppresses any h_debug and H—SYMBOL debug information in the 
final executable file, 
to filename 

specifies the name of the final executable module. If you do not specify 
the to option and you specify one filename on the slink command 
line, slink will use that filename (without the file extension) as the 
object module name. If you specify more than one filename, slink 
assumes that the first filename is the name of a startup module and 
will use the second filename as the object filename, 
verbose 

prints the names of each file as the file is processed. 
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verify filename 

specifies a file to which you want the linker to write all messages. If 
you do not specify the verify option, the linker writes all messages 
to stdout. You can abbreviate this option as ver. 
width n 

sets the maximum line length for the map and cross reference listing 
files. The default value is 80. This option is ignored if you do not 
specify the map option, 
with filename 

specifies a file containing slink options. The linker processes the 
contents of with files as if you had specified the option in the slink 
command. You can specify the with option as many times as 
necessary. Also, you can enter with options in a with file. 

The following is an example with file. 

from libsc.o vtlOO.o init.o window. o xmodem. o remote. o 
kermit.o script. o 
library lib:sc.lib lib:amiga.lib 
verbose 
smallcode 
smalldata 
to vtlOO 

Note: Do not confuse this option with the with compiler option, 
xref filename 

specifies a file to which you want the linker to write cross reference 
information. If you do not specify xref, but you specify the map 
option, the linker writes the cross reference information in the map 
file. 

Note: Do not confuse this option with the xref compiler option. 


Using Overlays 

Overlays are intended primarily for large applications that must run in a 
small amount of memory and leave more room for data. Overlays are 
groups of functions (and the data they require) that reside in memory 
only while in use. When the group in memory is no longer needed, the 
overlay manager reclaims the memory used by this group and loads in the 
next group of functions (and data). 

Before deciding to use overlays, consider using multiple shared 
libraries instead. If memory is tight, the AmigaDOS system removes 
unused shared libraries, thereby giving you some of the benefits of 
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overlays. On systems with more memory, the AmigaDOS system allows 
shared libraries to remain resident, which improves performance. Use 
overlays only in very tight memory situations. 

The overlays are organized into an overlay tree. The overlay tree 
consists of a root node, which is always resident in memory, and one or 
more overlays. Figure 8.1 shows an example overlay tree. 


Figure 8.1 

root 

An Example Overlay 

— £ 1 

Tree 


overlayl 

overlay2 


1 1 
overlay3 overlay4 


overlay5 


Overlays at the same level in the tree are mutually exclusive. In this 
example tree, the functions in overlays 1 and 2 are mutually exclusive, 
and the functions in overlays 3 and 4 are mutually exclusive. If any 
function in overlay 1 is running, overlay 2 cannot be loaded. However, if 
your program calls a function that is in overlay 2, the overlay manager 
reclaims the memory occupied by overlay 1 and loads overlay 2. Then, if 
your program calls a function in overlay 3, the overlay manager loads 
overlay 3. If overlay 3 is loaded, overlay 5 can be loaded if necessary, 
but overlay 4 cannot be loaded. 

A function in an overlay can call functions in only certain other 
overlays. For example, a function in overlay 3 can call a function in 
overlays 5 and 2 and in the root node. The following list shows which 
functions the functions in each overlay of the example tree can call. 

Functions 

in... Can call functions in... 

root can call functions in overlays 1 and 2 

1 can call functions in the root node 

2 can call functions in the root node and overlays 3 and 4 

3 can call functions in the root node and overlays 2 and 5 

4 can call functions in the root node and overlay 2 

5 can call functions in the root node and overlays 2 and 3. 
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As you can see, applications best suited to overlays are those that are 
modular and have a definite calling hierarchy among the functions. 

You must determine which functions should be in each overlay. Decide 
which functions can operate independently of others. The root node must 
contain your main program and should contain any functions that are 
called frequently or by many other functions in the program. The root 
node usually contains the libraries also. In general, the more frequently 
you call a function, the closer it should be to the root node. 

You can have up to 50 overlays. Your tree could have all overlays 
hanging from the root node, or your tree could be organized as one long 
chain of overlays. Organize the overlays of your tree efficiently; that is, 
according to the calling hierarchy of your program. If you create an 
inefficient tree, your program may not run efficiently because the overlays 
will have to be swapped more often. If you create an incorrect tree, 
slink issues a warning message. 

To use overlays, you should enter the overlay option and the overlay 
filenames in a with file, as follows: 

overlay 
overlay-t-filenames 
*overlay-2- filenames 


8 

List the filenames for each overlay on a separate line, and separate the 
filenames with plus (+) signs. If you cannot fit all of the filenames on one 
line, end the line with a plus sign, and enter the remaining filenames on 
the next line. Indicate the depth in the tree of the overlay by entering the 
appropriate number of asterisks at the beginning of the line. The overlays 
immediately beneath the root node are at depth 1, but you should not list 
them with asterisks. For overlays at depth 2, begin the line(s) with one 
asterisk; for overlays at depth 3, begin the line(s) with two asterisks, and 
so on. Enter an overlay immediately after the overlay to which it is 
subordinate. Terminate the overlay tree with a line consisting of a single 
pound (#) sign. 

For example, Figure 8.2 shows the same overlay tree as in Figure 8.1, 
but figure 8.2 shows which object files comprise each overlay. 
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Figure 8.2 
Example Overlay Tree 
with Filenames 



The with file for the example in Figure 8.2 looks like this: 
overlay 

beech. o+maple.o 
ash.o 

*f ir .o+pine.o 
♦•birch. o 

♦sweetgum.o+pecan.o 

» 


Suppose you have three files: hw . c, hello . c, and world . c. The file 
hw . c contains the following functions: 

finclude <stdio.h> 

int main(void) 

1 

Hello( void) ; 

World(void); 
return(O) ; 
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void SayWord(s) 
char *s ; 

( 

printf ( "Xs" , s); 

} 

The file hello . c contains only one function: 

void Hello(void) 

( 

SayWord! "\nHello, "); 

I 

world . c also contains only one function: 
void Horld( void) 

I 

SayWord ( "World ! \n" ) ; 

I 


After you compiled these three files, you have the three object files hw.o, 
hello. o, and world. o. To link this application, you can create a with 
file that contains all of the link options you need, including overlay 
specifications. 

from lib:c.o hw.o 
overlay 
hello. o 
world. o 

» 

library libssc.lib lib: amiga. lib 
map fhlosx 
to hw 

slink evaluates the with file, creates an executable module named hw, 
and creates a map file named hw.raap. The executable module consists of 
a root node and two overlays. The root node contains all of the code and 
data for c . o, hw.o, sc .lib, and amiga .lib. One overlay contains 
the code and data for hello . o, and the other overlay contains the code 
and data for world. o. Figure 8.3 shows the overlay tree for this 
application. 
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Figure 8.3 
Overlay Tree for hw 


Specifying 
Compiler Options 
with Overlays 



You can run this application in the same way you run an application 
that does not use overlays. The overlay manager loads overlays as 
necessary. 

Using overlays modifies the behavior of some compiler options. The 
following list describes each of the options affected by overlays. 
data=near 

places all data not declared with far or chip in the near 

data section. If you are using overlays, the near data segments of all 
files compiled with data=near are moved to the root node. 
Therefore, you cannot statically initialize near data items to point to 
code hunks that are not in the root node. For example, you cannot 
initialize a character pointer to a constant string in an overlay node if 
you specify the stringmerge option, 
smallcode 

merges all code hunks into a single hunk. If you are using overlays 
and you specify smallcode, slink merges as much of the code as 
possible without crossing overlay boundaries. The linker does not 
move code out of the overlay in which it was defined, 
smalldata 

merges all data and bss hunks into a single hunk. The near data 
section is always placed in the root node. However, slink does not 

merge hunks that are in overlays that are not named MERGED into 

the near data section, 
stringmerge 

places string constants into the code section, and the strings 
themselves are overlaid if the module they are used in is overlaid. 
Therefore, the value of the string constant may change as its overlay 
node is swapped out. For example, a function may return a string 
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Customizing the 
Overlay Manager 


constant or assign it to an external variable. It is recommended that 
you do not compile with stringmerge if you are using overlays. 

For some applications, you may want to replace the overlay manager with 
a custom overlay manager. For example, you can write an overlay 
manager to support function calls across mutually exclusive overlays. This 
section describes the necessary attributes of an overlay manager. 

The overlay manager must contain one code hunk named NTRYHUNK 
and define the global symbol _ovlyMgr. 

section NTRYHUNK, code 

xdef ovlyMgr 

First: 

bra FirstModule 


ovlyMgr: 


;Overlay manager code goes here. 


FirstModule: 

lea 

asl.l 
move . 1 
jmp 


First(PC) ,a3 

-4(a3),d7 

|4,d7 

d7,a3 

4(a3) 


• pointer to start of module 
; BPTR to next seglist entry 
; make into APTR 

; jump to code in next hunk 


Assemble this code with the -u assembler option so that the assembler 
adds the necessary underscores to all global symbols. 

The linker makes NTRYHUNK the first hunk in the executable and does 
not merge this hunk with any other hunks. Therefore, NTRYHUNK must 
also contain a valid entry point to the program and properly transfer 
control to the rest of the program. The first instruction in the preceding 
code branches to the symbol FirstModule, where the seglist is 
decoded, and a jump instruction transfers control to the next hunk in the 
segment list. 

For more information, examine the file ovs . a in the source 
directory. This file contains the source to the default overlay manager. 
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the Workbench Screen 
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147 Working with a rgc and a rgv 

147 Running From the Shell 
148 Running From the Workbench Screen 
149 Managing the Standard I/O Window 


Introduction 

If you run your program by double-clicking its icon from the Workbench 
screen, your program runs under a different environment than programs 
that are run from the Shell. Specifically: 


□ If not handled correctly, the command line arguments argc and argv 
receive different values that may cause unwary programs to crash. 

□ If your program uses stdin, stdout, or stderr, the standard I/O 


autoinitialization routine opens a console window to which your 


program writes output and from which it reads input. 


The following sections describe how to manage these unusual situations. 


Working with argc and argv 

Programs that run from the Workbench screen receive a different 
environment than those run from the Shell. The following sections 
describe the different environments. 

Running From the If you run your program from the Shell, your program receives two 
Shell arguments, argc and argv. argc is an integer guaranteed to have a 

value of at least 1. Unless you modify main as described in 

Chapter 10, “Using Startup Modules, Autoinitialization, and 
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Autotermination Functions,” argv is an array of 32 character pointers 
that point to the different items on the command line: 
argv [ 0 ] 

is a pointer to the name of the command that was executed, 
argv [ 1 ] to argv[n] 

are pointers to the arguments entered after the command. The number 
n represents the number of arguments specified. The maximum 
number of arguments is 30. 
argv[n + lj toargv[31] 
are NULL. 

If you run your program from the Workbench screen, the startup code 
sets up argv and argc in a different way than if your program is run 
from the Shell, argc is set to 0 (zero) to give you a quick way to check 
in your program if you are running from the Workbench screen, and 
argv is a pointer to a struct WBStartup instead of an array of 
character pointers. The definition of struct WBStartup is in the 
header file workbench/startup. h. 

To eliminate any problems caused by running your program from the 
Workbench environment, structure your program as follows: 

(include <workbench/startup.h> 

int main(int argc, char *argv[]J 

( 

struct WBStartup *startup; 
if(argc == 0) 

( 

/* The program was started from the Workbench. */ 

/* Use the WBStartup message instead of argc and argv. */ 
startup = (struct WBStartup *)argv; 


) 

else 

I 

/* The program was started from the Shell. */ 
/* Use argc and argv as usual. */ 


1 

1 

For more information on main, refer to SAS/C Development System 
Library Reference. 
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Managing the Standard I/O Window 

When you run a program from the Workbench screen that uses standard 
input or output, the standard I/O autoinitialization routine opens a 
standard I/O window in which your program can read from and write to 
stdin, stdout, and stderr. 

Note: If you do not use stdin, stdout, or stderr in your program, 
the compiler does not open a standard I/O window. If your code does not 
use the standard I/O streams directly, some library functions that your 
program calls may be using them. 

You can change the window’s location and size, and you can add a title 
to the window. To change the attributes of this window, you need to 

declare the external variable stdiowin in your program. Normally, 

the definition of stdiowin is taken from the library with which you 

link your program. However, if you declare stdiowin in your 

program, your version is used. 

This variable is declared in the SAS/C Libraries as follows: 

Iinclude <dos.h> 

char stdiowin! ]= "CON: 10/10/320/80/"; 

This specification opens a console window starting at location (10,10) that 
is 320 pixels wide and 80 pixels high. For more information on console 
specifications, refer to The AmigaDOS Manual, 3rd Edition (Commodore- 
Amiga, Inc. 1991). 

To change the window attributes, include a line similar to the previous 
line in any source file in your project. Declare this variable external to 
any function, and be sure to statically initialize the variable. Any changes 
made to this external variable after your program starts do not affect the 
window. 

Note: The replacement string for stdiowin must end in a slash 

(/), or it must end with a window title. 

For example, to make the initial window 600 pixels wide and 100 
pixels tall and add a window title of “My Window,” you would enter the 
following line: 

Iinclude <dos.h> 

char stdiowin! 1* "CON: 10/10/600/1 00/My Window"; 

If you are running under AmigaDOS 2.0 or later, — main appends 
the contents of the array stdiov37 to the stdiowin variable 



before opening the window. This array contains keywords that control 
other aspects of the window and is defined in the SAS/C Libraries as 
follows: 

((include <dos.h> 

char stdiov37[ ]= "/AUTO/CLOSE/WAIT" ; 

In the definition of stdiov37, you can specify any of the following 

keywords: 

AUTO 

indicates that you do not want the window to open unless output is 
written to or input is read from the window. 

CLOSE 

adds a Close gadget to the window. 

WAIT 

specifies that you do not want the window to close until the user clicks 
on the Close gadget or presses Ctrl-\ (End-of-File). 

WINDOW Oxaddress 

uses the window pointed to by the address. Specify the address in 
hexadecimal notation. 
screen name 

opens the standard I/O window on the public screen specified. 

You can also specify BACKDROP, NODRAG, NOBORDER, NOSIZE, 
simple, and SMART. These keywords control the same attributes as the 
similarly-named Intuition window flags. For more information on CON : 
keywords, refer to The AmigaDOS Manual, 3rd Edition (Commodore- 
Amiga, Inc. 1991). 

To change these keywords or add additional AmigaDOS 2.0 keywords, 
include a line similar to the previous line in any C source file in your 
project. Declare this variable external to any function, and be sure to 
statically initialize the variable. (Any changes made to this external 
variable after your program starts do not affect the window.) The 

keywords you specify are appended to stdiowin only if your 

program is running under AmigaDOS 2.0. If your program is run under 
earlier versions of the AmigaDOS operating system, you get a normal 
console window. 

Note: You must declare stdiowin and stdiov37 as external 

variables exactly as shown. Do not declare them as follows: 


char * — stdiowin = " specification /* WRONG! 
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Note: The source code to the standard I/O autoinitialization routine is 
in the sc: source directory in the file iob.c. 

For more information on stdiowin and stdiov37, refer to 

Chapter 6, “Predefined Data Name Reference,” in SAS/C Development 
System Library Reference. 
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Introduction 

This chapter describes how to use startup modules, autoinitialization 
functions, and autotermination functions. Specifically, it describes the 
following: 

□ the function of a startup module 

□ how to link your program with a startup module 

□ how to use the startup modules distributed with the SAS/C 
Development System 

□ how to write a program that does not use a startup module 

□ how to specify autoinitialization and autotermination functions. 



Understanding Startup Modules 

A startup module initializes the environment in which your program runs 
and performs certain cleanup tasks after your program has finished 
running. The SAS/C Development System provides seven startup 
modules: 

c . o is for use with standard programs, 
cres.o is for use with residentable programs, 
cback . o is for use with detachable programs, 
catch. o is for use when you are debugging standard 

programs. If your program terminates abnormally, 
this module asks you if you want to create a snapshot 
file. 

catchnr . o is for use when you are debugging standard 

programs. This startup module automatically creates a 
snapshot file if your program terminates abnormally, 
catchres . o is for use when you are debugging residentable 

programs. If your program terminates abnormally, 
this module asks you if you want to create a snapshot 
file. 

catchresnr.o is for use when you are debugging residentable 

programs. This startup module automatically creates a 
snapshot file if your program terminates abnormally. 


In addition, the module libent.o combines with libinit.o, 
libinitr .o, devinit.o, and devinitr.o to form startup code for 
libraries and devices. If you specify libinit, libinitr, devinit, or 
devinitr with the startup compiler option, then the compiler also 
uses LIB : libent . o before the specified startup file and tells the linker 
to generate a shared library or device. 

Note: The assembler source code for each of these startup modules is 
in the sc:source directory. 

The specific things that the startup module does depends on the startup 
module with which you link your program and on whether you run your 
program from the Shell or the Workbench screen. However, all startup 
modules perform some of the same tasks. For example, each startup 
module does the following: 


□ initializes the near BSS section. 

□ gets startup information from the Workbench screen (if invoked from 
the Workbench screen). 

□ marks the bottom of the stack. 
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□ calls fpinit, which calls any existing autoinitialization functions. 

□ calls main, which calls your program. If your program requires 

more than 30 command line arguments, you need to modify the default 
main function as described under “Modifying main.” 

□ calls f pterm, which also calls any existing autotermination 

functions. 


Modifying main 

The default ma i n function must convert the incoming command line 

to the (argc, argv) format required by the ANSI Standard. main 

performs this conversion by using a local array with 32 elements to 
represent argv. One element is used for the program name, and the 
ANSI Standard requires at least one NULL element at the end. Therefore, 
you are limited to 30 arguments on the command line of your program. 
If you need more arguments on the command line, you have two choices: 

□ If you only want to raise the argument limit, copy 
sc:source/_main.c to your project directory. Change the 

# define statement for the symbol MAXARG to the new maximum 
number of arguments. Then, recompile _main.c and link it into your 
program. 

□ If you need an unlimited number of arguments, copy 
sc:source/_main.c to your project directory. Modify the source 
code to allocate an array of pointers to use for argv. Make sure you 
use the mall oc or calloc function to allocate the memory. These 
functions will free the memory correctly when your program exits. 


Linking with a Startup Module 

To use a startup module, you must link your program with it. You can 
link your program by using the link option on the sc command or by 
entering the slink command. 

You can specify the link and, if necessary, the startup option on 
the sc command line. If you specify only the link option, sc tells the 
linker to link your program with c.o. If you want to link with another 
startup module, specify the module name with the startup option. If 
the module name that you specify does not contain a colon (:), forward 
slash (/), or period (.), sc adds the LIB: prefix and .o extension to the 
filename that you specify. For example, to link with cres.o, you can 
enter the sc command as follows: 


startup=cres link C-source-Ule 
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► Caution 


To specify a startup module with the slink command, enter the 
slink command in the following format: 

slink startup-module+obj-module to executable 
lib library-files 

The startup module must be specified before any object files. 

To use some startup modules, you need to declare certain variables in 
your program. The following sections describe how to use startup 
modules for the type of program you want to run. 

Programs linked with any startup module except cback.o run under 
the process in which they were invoked. When you enter the name of an 
executable module at the Shell prompt, that program runs in that Shell’s 
process and uses the Shell’s process number and stack (unless you specify 

a value for stack and the Shell’s stack is smaller than the specified 

value). Therefore, you cannot enter commands into or close the Shell 
from which the program was invoked until the program finishes running. 

Note: Even if you use the run command to run the program, you 
cannot close the window from which the program is run unless you 
redirect the input and output as in the following example: 

run >nil: <nil: program-name 

For most of your programs, you can use the default startup module, c . o. 

If you are debugging a standard program, you can use the catch. o or 
catchnr . o startup module to capture information if your program 
terminates abnormally. If you link with catch. o and your program 
terminates abnormally, catch. o asks you if you want to create a 
snapshot file. If you link with catchnr .o, the snapshot file is created 
automatically. A snapshot file contains traceback information for your 
program such as register values, symbol cross references, and stack 
information. 

Creating this snapshot file may corrupt your hard drive. 

Do not ship commercial products linked with catch. o or catchnr .o. 


You can use the tb utility to process this snapshot file and display the 
traceback information. For more information about processing snapshot 
files, refer to the description of the tb utility in Chapter 10, “Utility 
Reference,” of SAS/C Development System User’s Guide, Volume 2: 
Debugger, Utilities, Assembler. 
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Creating 
Detachable (Load 
and Stay 
Resident) 
Programs 


A detachable program is a program that runs in the background. It does 
not run as part of the originating Shell’s process. You can continue to 
enter commands into, or even close, the Shell from which the program 
was started without affecting the program. 

You can use the startup module cback . o to create detachable 
programs. When you link with cback . o, your program allocates a new 
stack and launches itself as a new process. For an example of a program 
that links with cback. o, see the directory sc : examples/cback. 

You should use cback . o for any program that: 


□ does not send output to the Shell from which it was invoked (except an 
initial banner) 

□ needs to be memory resident. 


To use cback.o, you add the following external definitions, which are 
declared in dos .h, to your main program if your program requires 
values other than the defaults: 


long stack => amount; 

allocates stack space for the created task. Many detachable programs 
only need a stack size of 4096 bytes (the default). However, you can 
change this figure to suit your application. 

char * procname = "program-name"; 

specifies the name of the process to be created. The default value is 
Background Process, 
long priority = priority; 

sets the priority of the process to be created. For most programs, you 
should set the task priority to 0, which is the default. However, you 
can change this figure to suit your application. 

long BackGroundIO = value; 

indicates whether output will be sent to the Shell from which the 
program was invoked. The default value is 0, which tells cback.o 
that no output is sent to the originating Shell. Setting this value to 1 
tells cback.o to set —Backs tdout to point to the Shell, 
extern BPTR —Backstdout; 

contains the file handle of the originating Shell (if BackGroundIO 

was set to 1). 

—Backstdout is an AmigaDOS file handle and, therefore, you must 
use the AmigaDOS function Write instead of the SAS/C functions such 
as write or fprintf to write to this file. 

You must close this file with the AmigaDOS Close function when you 
have finished writing to the Shell window. If you do not close 
—Backstdout, the originating Shell cannot close. 
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If your program creates a resident task that needs to print messages in 
the Shell, your program should pass —Backstdout to this task. 

If the —Backstdout file handle is NULL, your program cannot send 
output to the window. The handle may be NULL if the program was 
invoked from the Workbench screen or from another program that did 
not have a Shell open. 

If you want to make sure that only one copy of your program is 
running in the background, have your program create a global message 
port with an unique name. Subsequent invocations of your program 
should use the exec function FindPort to see if the port exists and, if 
the port exists, pass any commands to the running program through the 
message port and exit immediately. See the directory 
sc : examples/cback for sample code. 

Programs linked with cback . o cannot be made resident with the 
AmigaDOS resident command. 

Creating A resident program is a program that can be loaded permanently in RAM 
Residentable by the AmigaDOS resident command. AmigaDOS does not have to 
Programs reload a resident program each time you want to run it. 

To create a resident program, follow these rules: 

□ Compile with the data=near option (the default). 

□ Make sure that all external data declared with the far or chip 

keywords are read-only. 

□ Use ((pragma statements instead of the linker stubs in amiga . lib 
when possible because amiga . lib uses absolute addressing. If 
required, you can link with amiga .lib if the linker does not generate 
any warnings about references to absolute data. 

□ Link your program with cres . o instead of c . o. 

D Use the AmigaDOS resident command to add the program to the 
resident list maintained by the Shell. 

□ If you get a linker error because of too much near data, either use the 

far keyword to move some read-only data, compile with the 

stringsection option, or dynamically allocate some of your 
external data using malloc. 

A resident program must be re-entrant and re-executable, and it cannot 
write to far data. For each invocation of a resident program, cres . o 
copies the near data section, so the program can read and write to near 
data. If you link your program with cres . o and your program refers to 
far or chip data, the linker issues warnings. If your program only 
reads this data, you can ignore the warnings. You can add the const 
keyword to the declaration of the data item to eliminate the warnings. 

You cannot use the saveds keyword or compile with the saveds 

option if you link with cres . o. 
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Each time the program is run, a new near data segment is created, 
initialized data are copied into the new segment, and relocations are 
performed inside the segment. When the program finishes, the segment is 
released. 

slink creates the following symbols when you link your program: 
—LinkerDB points to the original near data section. 

RESBASE specifies the offset of —LinkerDB in the near data 
section (0 or 0x8000). 

RESLEN specifies the total number of bytes of initialized and BSS 
data. 


newdatal specifies the number of longwords of initialized data. 


For more information about resident programs, refer to the description 
of the AmigaDOS resident command in Using the System Software 
(Commodore-Amiga, Inc. 1990) or see the example in 
sc : examples /cres. 

If you are debugging a residentable program, you can use the 
catchres.o or catchresnr.o startup module to capture information 
if your program terminates abnormally. If you link with catchres.o 
and your program terminates abnormally, catchres . o asks you if you 
want to create a snapshot file. If you link with catchresnr . o, the 
snapshot file is created automatically. A snapshot file contains traceback 
information for your program such as register values, symbol cross 
references, and stack information. 


► Caution Creating this snapshot file may corrupt your hard drive. 

Do not ship commercial products linked with catchres .o or 
catchresnr.o. A 


You can use the tb utility to process this snapshot file and display the 
traceback information. For more information about processing snapshot 
files, refer to the description of the tb utility in SAS/C Development 
System User’s Guide, Volume 2. 

Creating Shared You can use the modules libent.o, libinit.o, and libinitr.o to 
Libraries create shared libraries. For information on creating shared libraries, 
refer to SAS/C Development System Library Reference. 



Writing Applications without a Startup 
Module 

If you do not want to link your program with a startup module, follow 

these guidelines when writing and compiling your program: 

□ Your program must initialize DOSBase and SysBase, if your 
program makes any calls to dos . library and exec, library, 
respectively. For additional information, see “Initializing System 
Library Bases,” later in this chapter. 

□ Do not use any SAS/C I/O functions such as fopen, read, printf, 
and so on. 

□ Add the saveds keyword to the first function in the first object 

module in your program. 

□ Compile your program with the nostackcheck option. 

□ Be aware that the uninitialized near data are not initialized to 0 under 
AmigaDOS version 1.3. 

□ Register AO points to the command line entered by the user. You can 
parse the arguments from AO or, under AmigaDOS 2.0, call 
ReadArgs to get the arguments. 

□ Your program will start executing at the first function in the first 

module specified on your slink or sc command line. This function 
should be declared with the saveds keyword. 

□ Unless you write code to reply to the Workbench startup message, your 
program will not run from the Workbench screen without crashing the 
machine. 

For an example, see sc : examples/nostartup. 


Using Autoinitialization and Autotermination 
Functions 

If you link with one of the startup modules provided by the SAS/C 
Development System, you can designate functions as autoinitialization 
functions, which are called before your program starts and as 
autotermination functions, which are called after your program 
terminates. 

Priorities determine the order in which autoinitialization functions and 
autotermination functions are called. Various library routines have 
autoinitialization and autotermination functions that run at lower 
priorities than the default for user routines. Table 10.1 shows the 
priorities for various types of autoinitialization functions. 
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Table 10.1 

Priorities for 
Autoinitialization and 
Autotermination 
Functions 


Function Type 

Priority 

floating-point initialization 

100 

clock and sprof 

150 

shared libraries 

200 

cover 

210 

memory cleanup 

250 

stack extension cleanup 

250 

standard I/O 

500 

C+ + I/O streams 

4990 

C+ + user constructors and destructors 

5000 

default 

30000 


The lower the number, the higher the priority (that is, the earlier the 
autoinitialization function is executed). Autoinitialization functions with 
the same priority are executed in the reverse order that they are 
encountered during linking, for compatibility with the way constructors 
are handled under UNIX C++. 

To designate an autoinitialization function, begin the function name 
with _STl_nnnn_, where nnnn is the priority at which you want the 
function to run: 

STI-priority-Junction-name 

The priority can be a number between 0 and 32767. Autoinitialization 
functions that are missing the _ priority _ part are assigned a default 
priority of 30000. 

Autoinitialization functions take no parameters but can return a 
nonzero return value to indicate a fatal error. If an autoinitialization 
function returns a nonzero value, the startup code will call all 
outstanding terminators and kill the program. You can still use 
autoinitialization functions that return a void. The compiler will assume 
that these functions are successful. 

To designate an autotermination function, begin the function name with 
— std — , as follows: 


SiD-priority— function-name 



All autotermination functions are executed in the reverse order of 
priority. Autotermination functions take no parameters and return no 
values. 

For example, you could declare autoinitialization and autotermination 
functions as follows: 

int _STI_550_myinit(void) 

1 

/* your code here */ 

) 

void _STD_550_myterm( void) 

I 

/* your code here */ 

1 

The linker searches the functions defined in your program for functions 
whose names start with the _STI or _STD. All functions starting with 

STI are assumed to be autoinitialization functions and are called from 

the startup code before main is called. All functions starting with 

_STD are assumed to be autotermination functions and are called after 
your program exits. If the linker finds at least one autoinitialization 
function, it creates an array of function pointers containing one pointer 

for each autoinitialization function. The array is named ctors, and 

its last entry is always NULL. The f pinit function looks through this 

array and calls each autoinitialization function before calling main. 

Similarly, if the linker finds at least one autotermination function, it 

creates an array of function pointers called dtors containing one 

pointer for each autotermination function. The array’s last entry is always 

NULL. The f pterm function looks through this array and calls each 

autotermination function after your program exits. 

The source for f pinit and f pterm is in the sc : source 

directory. 

The following figure shows the order in which modules are called when 
you run your program. 
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Figure 10.1 
Startup Modules, 
Autoinitialization 
Functions, and 
Autotermination 
Functions 


Startup module 



If slink does not find any autoinitialization or autotermination 

functions, it substitutes a longword zero for any references to ctors 

or dtors. If you write your own startup module, check that 

ctors and dtors are not NULL before accessing the array. 

You can use level 1 or 2 I/O functions (such as fopen and open) in 
your autoinitialization and autotermination functions, but only if your 
autoinitialization and autotermination functions are running at a higher 
priority than 500. 

You can use the ANSI standard memory allocation routines (such as 
malloc, free, and calloc) in autoinitialization and autotermination 
functions. All memory allocated with these routines and not yet freed in 
your program is still valid in your autotermination functions, as long as 
your autotermination functions have a priority greater than 250. 

Stack checking and stack extension in autoinitialization and 
autotermination functions are disabled by the compiler. Even if you 
compile your autoinitialization or autotermination function with the 
stackcheck and/or stackextend option, your function works as if 
you had not specified either of these options. 


Initializing System Library Bases 

If you declare but do not define a system library base in your own code, 
the library base is automatically initialized. The autoinitialization code 
calls OpenLibrary to initialize the library base, and the 
autotermination code calls CloseLibrary to close the library. In the 
following example, IntuitionBase is automatically initialized. 
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(include <proto/intuition.h> 

/* The following line declares IntuitionBase but does */ 
/* not define it. This line is not required, because */ 
/* proto/intuition. h also declares IntuitionBase. 

/* this program, IntuitionBase is automatically 
/* initialized. 

extern struct IntuitionBase *IntuitionBase; 

int main(void) 

[ 

struct Window *w; 
w = OpenWindow( . . . ) ; 



) 

The following table lists the system libraries whose bases are 
automatically initialized by the autoinitialization code. 


Table 10.2 

Library Bases For 

Name 

Base 

. library Files 

asl. library (2.0) 

AslBase 


commodities . library (2.0) 

CxBase 


diskfnt . library 

Diskf ontBase 


dos . library 

DOSBase 


expansion. library 

ExpansionBase 


gadtools . library(2.0) 

GadToolsBase 


graphics . library 

Gf xBase 


icon. library 

IconBase 


iff parse. library 

IFFParseBase 


intuition. library 

IntuitionBase 


keymap .library 

KeymapBase 


(continued) 
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Table 10.2 

(continued) 


Name Base 


layers . library 
mathf fp. library 
mathieeedoubbas . library 
mathieeedoubtrans . library 
mathieeesingbas .library 
mathieeesingtrans . library 
mathtrans . library 
exec . library 
translator .library 
utility. library 
workbench. library 


LayersBase 

MathBase 

MathleeeDoubBasBase 

MathleeeDoubTransBase 

MathleeeSingBasBase 

MathleeeSingTransBase 

MathTransBase 

SysBase 

Translator Base 

UtilityBase 

WorkbenchBase 


As stated before, a system library base is not initialized if you define 
the library base in your code. For example, the following code defines the 
library base and, therefore, the base is not automatically initialized. 


f include <proto/intuition.h> 

/* The following line defines IntuitionBase, so */ 
/* it is not automatically initialized. */ 

struct IntuitionBase *IntuitionBase; 


int main (void) 

( 

struct Window *w; 

w = OpenWindow( . . . ) ; /* Crash! IntuitionBase in NULL */ 


For more information on defining library bases, refer to SAS/C 
Development System Library Reference. 

The autoinitialization functions pass the value of the external long 
integer oslibversion to OpenLibrary. If your program runs 



only under a specific version of the operating system, declare this 
variable in your code and initialize it as necessary. For example, if your 
program requires the AmigaDOS operating system, Version 2.0 (which is 
library revision 37), you can enter the following line in your program 
external to any function: 

long oslibversion = 37; 

The following table lists the library revision numbers for each version of 
the operating system. 


OS Library 
Version Revision 

1.2 33 

1.3 34 

2.0 36 (Preliminary 2.0) 

2.04 37 

2.1 38 

3.0 39 

3.1 40 

If the autoinitialized libraries cannot be opened, the library function 

autoopenfail is called. The version of autoopenfail in the 

libraries prints a message indicating which library could not be opened 
and then terminates your program. You can replace this function by 
declaring it in your code as follows: 

void autoopenfail(char *lib) 

1 

/* your code here */ 

1 


The lib parameter is the name of the library that failed to open. If you 

want your program to terminate after the call to autoopenfail, the 

last action of autoopenfail should be to call —XCEXIT. If 
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autoopenfail returns without calling —XCEXXT, the startup 

proceeds normally. 

The source code to the default autoopenfail function is in 

sc : source/autoopenfail . c. As an additional example, 
sc: source/intuitlib . c contains the autoinitialization and 
autotermination code for intuition, library. 



168 



169 


- 11 


Using SAS/C Extensions to 
the C and C++ Languages 

169 Introduction 

1 70 Using Special Keywords 

171 Using aligned 

172 Using chip, far, and near 

1 73 Using interrupt 

1 73 Using asm, _ —regargs, And stdargs 

1 74 Using saveds 

1 75 Using inline 

1 76 Managing Stack Space 

1 77 Using # pragma Statements 

179 Using Unnamed Unions 

180 Using Implicit Structure References 

181 Using Equivalent Structures 
183 Using Zero-Length Arrays 

183 Specifying the Size of Enumerated Types 

184 Using the sizeof and Comma Operators in Preprocessor Directives 

184 Using C+ + Style Comments 

185 Using Nested Comments 

185 Using National Characters in Variable Names 
185 Using Dollar Signs in Variable Names 
185 Using Relaxed Ref-Def Model External Data 


Introduction 

This chapter describes features of the SAS/C Compiler that are not 
defined by the ANSI C Standard or by The Annotated C+ + Reference 
Manual. Specifically, the compiler allows you to do the following: 

□ use special keywords such as aligned and saveds 

□ use # pragma statements 

□ declare and refer to structure members in special ways 

□ change the size of enumerated types 

□ use the sizeof and comma (,) operators in #if directives 

□ use C+ + style and nested comments 

□ use national characters in variable names 

□ use dollar signs in variable names 



□ use the common model or the strict reference-definition model for 
external data. 


Using Special Keywords 

The SAS/C Compiler and C++ translator allow the following keywords: 
aligned 

forces an item to be aligned on a four-byte (longword) boundary or 
forces the declared function to align its stack in the prolog. 

chip 

places the declared static or external data into chip memory. 

far 

places the declared static or external data into the far data section 
or forces calls to the declared function to be made with 32-bit 
references. 

near 

places the declared static or external data into the near data section 
or forces calls to the declared function to be made with 16-bit 
references. 

interrupt 

indicates that a function may be called as an interrupt routine. 

asm 

allows you to specify which registers a function uses to receive 
parameters. 

regargs 

forces a function to receive parameters in registers. 

stdargs 

forces a function to receive parameters on the stack. 

saveds 

loads the global data register at the entry to the function. The method 
used depends on the compiler options you specify. 

inline 

indicates a function that can be inlined by the global optimizer. 

stackext 

indicates a function that should allocate a new stack if the old one is 
too small. 

The following sections describe each of these keywords. The 
stackext keyword is described under “Managing Stack Space.” 
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When used on functions, these keywords must be specified in the 
correct places, depending on whether the keyword affects the calling 
function (the caller) or the function being called (the callee). The following 
list summarizes these points. 

□ Keywords that affect the function’s definition (the callee) only must 

appear on the function definition. They may appear on prototypes, but 
they are optional. These keywords generate warnings if placed on 
function pointers or data items because they are unnecessary, but the 
compiler still generates correct code. Keywords in this category are 
aligned, interrupt, saveds, and stackext. 

□ Keywords that affect both the caller and the callee must appear both on 
the function definition and its prototype. You are required to have a 
prototype for the function and to add the keywords to the declaration 
of any function pointers. If you do not do this, incorrect code is 
generated to pass parameters. For example, if you assign a 

regargs function to a function pointer and compile with the 

parms=stack option, parameters are passed to the regargs 

function on the stack instead of in registers. Keywords in this category 
are asm, stdargs, and regargs. 

□ Keywords that affect only the calling function are required on function 
prototypes only. The keywords are ignored if they appear on function 
definitions or function pointers. Keywords in this category are 

near and far. 

Be careful when specifying a keyword on a function pointer. The 
indirection operator (*) in a function definition resets all special 
keywords. To declare a pointer to a function that, for example, takes its 
arguments in registers, declare the pointer as follows: 

void (* regargs func)(int x, char *p); 

If you declare the pointer as in the following example, the regargs 

keyword is attached to the function pointer itself rather than the function 
to which the pointer points: 

void regargs (*func)(int x, char *p); 

Using aligned The aligned keyword on a variable declaration forces the variable 

being declared to be aligned on a four-byte data boundary relative to the 
start of the data area in which it is being declared. For structure 
members, the data area is the start of the structure. For automatic 
variables, the data area is the beginning of the stack frame for the 
function in which they are declared. For static and external variables, 



172 Chapter 11 


the data area is the base of the chip, near, or far data section, depending 
on the section in which the variable is being allocated. 

On functions, the aligned keyword ensures that the stack is 

aligned. 

The SAS/C Compiler normally makes sure that the stack is aligned at 
the beginning of your program and remains aligned for the duration of 
the program. However, if your code is called from code not compiled 
with the SAS/C Compiler, you cannot be sure that the stack is correctly 

aligned at the start of your function. In that case, the aligned 

keyword may not work for automatic variables. For example, your code 
may be: 

□ called from assembly-language code 

□ an interrupt routine 

□ a callback function 

□ in a shared library. 

To make sure that the stack is aligned at the beginning of a function, 

declare the function itself with the aligned keyword. This action 

forces the code generated for the function to align the stack on entry. 
However, the compiler devotes an address register to pointing to the old 
stack, thereby reducing the number of address registers available for 
register variables. 

Using chip, The near, far, and chip keywords on data items allow you 

far, and to specify the section in which you want the compiler to place the item. 

near On functions, the near and far keywords are required on the 

function prototype only. 

By default, the compiler puts all declared static or external data into 
the near data section. Register A4 points to the start of this section. The 
compiler generates 16-bit references relative to A4 for external or static 
items in the near data section. These references generate less code than 
full 32-bit references. 

For all items in the far data section, the compiler generates 32-bit 
references. When the system loader loads your program, it changes these 
32-bit references to the actual address of the data item. 

The compiler also generates 32-bit references to items placed in chip 
memory. Chip memory is the lowest 512K to 2M of system memory, 
depending on the version of the hardware that you are running. This 
memory is the memory on your machine that is usable by the custom 
graphics and sound chips to store bitmaps, sound samples, and so on. 

You can use the data compiler option to change the default data 
section for external and static data. You can also override the default for 

individual data items by declaring the item with the near, far, or 

chip keyword, as in the following example: 
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Using 
interrupt 


Using asm, 

_regargs, And 
stdargs 


near char a [ 1 0 ] ; /* Allocate a 10-byte array in the near sec*/ 

far char b [ 10] ; /* Allocate a 10-byte array in the far sec */ 

chip char c[10]; /* Allocate a 10-byte array in the chip sec*/ 

For compatibility with previous releases, the compiler accepts the 
near, far, and chip keywords without the leading underscores. 

However, these forms of the keywords violate the ANSI Standard and are 
not allowed if you specify the ansi compiler option. 

On function declarations, the chip keyword is meaningless. 

However, functions declared with the near keyword are always 

called with a 16-bit relative branch even if you compile with the 

code=far option. Functions declared with the far keyword are 

always called with a 32-bit branch even if you compile with the 
code=near option. For example, the following function is called with a 
32-bit branch: 

far int func(int x); 

You can declare a function with the interrupt keyword to indicate 

that the function is called from an interrupt routine. Defining a function 

with the interrupt keyword turns off the stack checking and 

extension code for that function and sets condition codes on return. The 

interrupt keyword is required on function definitions and tolerated 

on function prototypes. This keyword is meaningless on function pointers 
and other data items. 

The interrupt keyword does not imply that the function will be 

called with stack arguments. If you compile the function with 
parameters “register, but the function must receive its parameters 

on the stack, add the stdargs keyword to its definition and 

prototype. 

Normally, C functions pass and receive parameters by placing them on 
the stack. C+ + functions pass and receive some of their parameters in 
registers and some on the stack. To change the way parameters are 

passed, you can declare the function with the asm, stdargs, or 

regargs keyword or compile the function with the 

parameters = register option. 

If you declare a function with the asm keyword, you can specify the 

registers in which the function receives each parameter. For more 

information about the asm keyword, refer to Chapter 11, “Using 

Assembly Language with the SAS/C and C+ + Languages," in SAS/C 
Development System User’s Guide, Volume 2: Debugger, Utilities, Assembler. 

The function receives some of its arguments in registers instead of on 
the stack if: 
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□ You declare a function with the regargs keyword. 

□ You compile the function with parameters = register. 

a The function has C+ + linkage and you did not specify any special 

keywords. 

Specifically, the first two pointer arguments are in registers AO and Al, 
and the first two integral arguments are in DO and Dl. If you compiled 
with the math=6888 1 option, the first two doubles are in registers 
FPO and FP1. All other arguments are passed on the stack. 

The compiler identifies functions that expect arguments in registers to 
the linker by placing an at sign (@) in front of the function name. The at 
sign replaces the underscore that the compiler normally places at the 
beginning of function names. 

If you compile your application using parameters=register but 
you want one or more functions to receive parameters on the stack, or if 
you want your C+ + functions to take parameters on the stack, declare 

those functions with the stdargs keyword. The stdargs 

keyword forces a function to receive parameters on the stack. 

If you write a C function that has the same name as a C library 

function, you need to add the regargs keyword to your function or 

compile with the parras=both or parms=register option. For 
example, you may want to replace the SAS/C library function malloc 
with your own version of malloc. If you compile with the 
parms = stack option or define your version of malloc with the 

stdargs keyword, then two versions of malloc are linked into your 

executable. If you use other SAS/C library functions that call malloc, 
these functions use the version of malloc in the SAS/C libraries. 
However, your functions that call malloc use your version of malloc. 
To make sure that all calls to malloc are using your version of malloc, 

define your version with regargs or compile with the parms-both 

or parms = register option. 

The asm, regargs, and stdargs keywords are important 

on function definitions and prototypes, and function pointers. 


Using saveds If you define a function with the saveds keyword, the compiler 

generates extra code at the beginning of the function that loads the 
address of the near data section into register A4. Defining a function with 

the saveds keyword is equivalent to compiling that function with the 

saveds compiler option. 

Loading A4 with the address of the near data section is useful if the 
function in question is called from outside your program. For example, 
your function may be a callback function or may be a function in a 
shared library. 
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If you do not compile your function with the libcode option, register 
A4 is initialized with the contents of the absolute symbol —LinkerDB, as 
follows: 

LEA -LinkerDB, A« 

If you compile your program with the libcode option, the linker 
treats —LinkerDB as an offset relative to register A6 (the library base) 
instead of an absolute symbol. Register A6 points to the library base at 
all entry points to the library. In this case, the instruction generated to 
load A4 is as follows: 

LEA _LinkerDB( A6) ,A4 

—LinkerDB is initialized by the linker to point to the near data 
section. 

Programs that are residentable cannot refer to absolute symbols. 

Therefore, you cannot use the saveds keyword or saveds compiler 

option if you intend to link your program with the cres . o or 
catchres.o startup modules. 

Defining your function with the saveds keyword is equivalent to 

calling the function geta4 as the first executable statement of your 
function, get a 4 is provided for compatibility with previous versions of 
the SAS/C Compiler and with other Amiga compilers. 

The saveds keyword is important in function definitions and is 

tolerated but not required in function prototypes. If you include the 

saveds keyword on the prototype for a function but not on the 

function definition, an error message is issued if the keyword is missing 
from the function definition. This keyword is meaningless on function 
pointers and other data items. 

Using inline If you define a C function with the inline keyword, the global 

optimizer generates code for the specified function at the point the 
function is called, instead of generating an actual call to the function. 

Using the inline keyword can increase code size, but it can make 

your code run faster. It also allows the global optimizer to perform more 
optimizations. If you do not compile with the optimize option, the 

inline keyword is ignored, and code is generated to call the 

_ — ^ function normally. 

The inline keyword is required only on function definitions, not 

on function prototypes. This keyword is meaningless on function pointers. 

Note: inline isaC keyword. If you are using C++, use the 

inline keyword. When you use the inline keyword on a C+ + 
function, C+ + translates this to inline in the generated C code. 



Managing Stack Space 

The stack is a writeable memory area whose size is set by the AmigaDOS 

stack command or by the external long integer stack . The default 

stack size is four kilobytes. This stack is used during function calls for 
saving registers and passing arguments. Within a function, automatic 
variables are allocated from the stack. For many C programs, a four- 
kilobyte stack is adequate. 

Note: Shared libraries do not have their own stack. Instead, they use 
the stack of the caller program. Therefore, you cannot use the stackext 

or stackcheck options or the stackext keyword when compiling 

functions for a shared library. 

If you compile your program with the stackcheck option (the 
default) and your program overflows its assigned stack area, the stack 
overflow routine _CXOVF is called. The _CXOVF routine provided with 
the SAS/C libraries displays a requester and aborts the program. 
However, you can replace the version of _CXOVF supplied by the SAS/C 
libraries with your own version. 

If you do not want your program to abort because of a lack of stack 
space, you can allocate additional stack space in one of four ways: 

□ Increase the value of the external long integer stack stack 

specifies the minimum stack size needed for your program to run. If 

the default stack is smaller than stack, the startup code allocates a 

new stack of stack bytes. If you do not compile with stackext, 

the stack space is allocated once by the startup code, so your program 

does not take longer to run. Changes made to stack after your 

program starts take effect only if new stack extents are allocated 

because of code compiled with the stackext keyword or the 

stackext compiler option. 

□ Declare functions that require a large amount of stack space with the 

stackext keyword. This keyword generates extra code at the start 

of the function. This extra code compares the amount of stack available 

with the amount specified in the external long integer STKNEED. 

STKNEED specifies the minimum amount of stack needed by each 

function in your program. If enough stack is not available, the function 
allocates a new stack extent whose size is specified in the external long 

integer stack. If there is not enough memory to allocate the new 

stack, the stack overflow routine _CXOVF is called, just as if normal 
stack-checking code was active instead of the stack extension code. 

When the function returns, the old stack is restored and the extra 

stack is freed. Declaring a function with the stackext keyword is 

equivalent to compiling the function with the stackext compiler 
option. 
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□ Compile your program with the stackext option. Compiling with the 
stackext option is equivalent to defining all functions in your 

program with the stackext keyword. If you have specific 

functions that use a lot of stack space or are recursive, you may want 

to define those functions with the stackext keyword instead of 

compiling your entire program with the stackext option. 

□ Increase the value of the external long integer stkneed and 

compile your program with the stackext option. You should never 
set stkneed to less than 400 bytes (which is the default value). 

Note: stack specifies the total number of bytes needed during the 

entire duration of your program. STKNEED gives the minimum free 

stack required by each function. 

Note: Using the stack extension feature adds overhead to each 
function entry point and requires the use of an additional address 
register. Therefore, your program will run slower. 

The stackext keyword is important only on function definitions. 

This keyword is meaningless on function pointers and tolerated on 

function prototypes, but not required. If you include the stackext 

keyword on the prototype for a function, an error message is issued if the 
keyword is missing from the function definition. 

Even if you compile your program with stackext, your program may 
still run out of stack space if it calls a function not compiled with 
stackext. If you call shared libraries or code compiled with other 
languages, your program may run out of stack space. Also, the SAS/C 
library routines are not compiled with stackext, but they use little 
stack space. The stack extension code allows some extra space for the 
library routines. 

In the same application, you can use functions compiled with 
stackcheck, functions compiled with stackext, functions compiled 

with neither option, and functions defined with the stackext 

keyword. If you compile a function with both stackext and 
stackcheck, the compiler ignores the stackcheck option. 

For more information on the stack integer, refer to SAS/C 

Development System Library Reference. 

Using #pragma Statements 

The SAS/C Development System supports seven types of # pragma 
statements: 

□ f libcall 

□ libcall 

□ amicall 
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□ regcall 

□ syscall 

□ tagcall 

□ msg. 

The ((pragma flibcall, libcall, syscall, and tagcall 
statements allow you to call various library routines directly. The 
0 pragma amicall and regcall statements are provided for 
compatibility with Aztec C. These ((pragma statements are described in 
SAS/C Development System Library Reference. 

Note: Currently, the AmigaDOS system libraries do not accept 
parameters in floating-point registers. However, if you create your own 
libraries that accept parameters in floating-point registers, you should use 
((pragma flibcall. 

The SAS/C Compiler also supports ((pragma msg statements. 

# pragma msg statements allow you to specify whether a message should 
be ignored, treated as an error, or treated as a warning message. For 
example, if you know that your code produces a specified warning on a 
certain line, you can use a ((pragma msg statement to suppress the 
warning on that line, ((pragma msg only works on messages numbered 
1 to 299, which means that ((pragma msg does not work on C+ + 
translator messages. 

Note: You cannot turn a message that is by default an error into a 
warning. 

How a specific message is treated is referred to as its state. Using 
# pragma msg statements, you can save the state of a message, change 
its state, or restore a message’s previous state. 

The msg statement can take one of the following forms: 

# pragma msg num [error | warn | ignore] [push] 

((pragma msg num pop 
where 

num identifies the number of the message, 
error indicates that the message should be treated as an error. You 
can abbreviate this keyword as err. 
warn indicates that the message should be treated as a warning, if 
possible. You can abbreviate this keyword as wrn. 
ignore indicates that the message should be ignored, if possible. You "• 
can abbreviate this keyword as ign. 
push saves the message’s state (before changing it). If you specify 
push, this keyword must appear after the error, warn, or 
ignore keyword. 
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pop restores the message’s previous state. 

With the push and pop keywords, you can turn a message on or off for 
a specific line, series of lines, or header file, then restore the message to 
the value the user specified on the command line. 

For example, the following code produces message number 85 because 
it returns an int but no return value is specified. However, the code is 
correct because the exit function never returns. The first # pragma 
statement tells the compiler not to produce a warning on that line. The 
second # pragma tells the compiler to generate a message for the 
remaining functions in the file, if necessary. 

int func(void) 

1 


exit(O); /* Never returns */ 

Ipragma msg 85 ignore /* Turn off warning 85 */ 

1 

Ipragma msg 85 warning /* Turn on warning 85 */ 
int func2(void) 

I 


| /* A warning here is VALID and is produced due to the */ 

/» second Ipragma statement above. */ 

If you want to suppress warning 93 (for unused variables), 

((pragma msg 93 ignore must be in effect when the compiler 
reaches the line containing the last closing brace (}) for the function. If 
you turn the warning off only for the line containing the declaration of 
the variable, the compiler will still generate message 93 when it reaches 
the last line of the function. The line number displayed for the message 
will be the number of the last line in the function. 


Using Unnamed Unions 

The SAS/C Compiler and C++ translator support unnamed unions as 
structure members. For example, you could define the following 
structure: 
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struct FOO 

I 

union 

I 

int x; 
double d; 

); 

long 1; 

I foo; 

The union in this structure does not have a name. The union members 
are treated as if they are members of the structure, except that the union 
members start at the same offset relative to the base of the structure. In 
this example, you can refer to member x as f oo . x. 


Using Implicit Structure References 

Note: Implicit structure references work only from C programs, not 
C+ + programs. 

If you declare a substructure in your C program, and the names of the 
members in the substructure are unique, you can refer to the members 
using only the structure name and member name. You do not need to 
include the substructure name in the reference. For example, you could 
declare the structure BAR and the substructure FOO as follows: 

struct F00 
I 

int x; 
double d; 

I; 

struct BAR 

I 

struct FOO foo; 
int 1 ; 

) bar; 

You can refer to members x and d in the substructure as follows: 

bar.x = 10; 
bar .d = 10.0; 
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Referring to substructure members as shown generates warning message 
193. If your program refers to substructure members in this way, 
suppress warning 193 by compiling your program with the ignore 193 
compiler option. 

If two or more substructures contain a member with the same name 
and you do not specify the substructure name when you refer to the 
member, the compiler generates error message 123. The compiler cannot 
determine which substructure member you are trying to reference. 


Using Equivalent Structures 

Note: The structureEquivalence option is ignored when 
compiling C+ + programs. 

If you compile your C program with the StructureEquivalence 
option, the compiler does not issue messages if a pointer to one structure 
type is passed to a function when the function expects a pointer to a 
different type, if the type passed is equivalent to the type expected. 

A structure is defined to be equivalent if it maps the same base data 
types in the same order as the desired structure type. If one structure is 
longer than another, but it is identical through the length of the shorter 
one, then the longer structure is an acceptable substitute for the shorter, 
but the shorter structure is not an acceptable substitute for the longer 
structure. The function receiving the pointer may try to write to one of 
the fields that does not exist in the shorter structure. Therefore, you can 
pass an intuiMessage structure to the exec function PutMsg without 
getting a warning, but the compiler issues a warning if you assign the 
result of a call to GetMsg to an IntuiMessage pointer. 

For example, you could define the following structures: 

struct F00 

I 

int x; 

int y; 

1 ; 

struct BAR 

{ 

int x, y, z; 

If 


The structure BAR is equivalent to the structure FOO. If you specify 
structure equivalence, the compiler does not issue a warning for 
passing a pointer of type bar to a function whose prototype specifies a 
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structure of type FOO. However, the structure FOO is not equivalent to 
BAR because FOO is not long enough. If you tried to pass a pointer to a 
structure of type FOO to a function whose prototype specified a pointer to 
a structure of type BAR, you would get a compiler warning. 

BAR is also equivalent to FOO if you define them as follows: 

struct FOO 

( 

int x, y; 

1; 

struct BAR 

f 

struct FOO foo; 

int z; 

1; 


Similarly, you can pass a struct intuiMessage * to a function 
that requires a struct Message *, since a struct Message is the 
first element of a struct IntuiMessage. (struct IntuiMessage 
is defined in the system header file intuition/intuition.h.) This 
option also allows you to pass a pointer to an lOExtSer structure to a 
routine that wants a pointer to an ioRequest structure, such as the 
routine DolO. lOExtSer is identical to IoRequest for the length of 
the IoRequest structure. 

The following example is more complicated, but BAR is still equivalent 
to FOO: 

struct FOO 

I 

int x, y, z; 

1; 


struct BAR 

( 

struct 

1 

int a; 

1 x; 
struct 

I 

int b, c; 

1 y; 
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int z; 


I; 


The structure type FOO defines memory as three consecutive integers. 
BAR also defines memory as three consecutive integers, although it does 
so through the use of two different substructures. The substructures are 
not considered when determining equivalence. 


Using Zero-Length Arrays 

You can use zero-length arrays as the last element of a structure. For 
example, you can declare structure FOO as follows: 

struct FOO 

( 

long maxalloc; 
long curalloc; 
long mem[ 0 ] ; 

); 


This structure is 8 bytes in length as reported by sizeof . Using zero- 
length arrays is most useful when you need to allocate variable-sized data 
items. For example, if you need 100 elements in the above array at run- 
time, you can do the following: 

struct POO *foo; 

foo = malloc(sizeof (struct FOO) + 100*sizeof (long) ) ; 
foo->mem(50] = 10; 
foo->mem[56] = .... 


Specifying the Size of Enumerated Types 

By default, enumerated types are integers and integers are 4 bytes long. 
For example, each of the identifiers of type cats is 4 bytes long. 

enum cats (bombay, ocicat, somali); 

If you compile this line with the shortintegers option, the identifiers 
are 2 bytes long. 

The SAS/C Compiler also allows you to control the size of enumerated 
types in C by declaring them with the char, short, or long keywords, 
as in the following examples: 



char enura flintstones (Fred, Barney, Wilma); 

short enum colors (red, green, blue, orange, yellow); 

long enum seasons (spring, summer, fall, winter); 

The identifiers of type flintstones are 1 byte long; the colors are 2 
bytes long, and the seasons are 4 bytes long. When you declare a 
variable of a specific enum type, you must include the extra keyword on 
the variable’s declaration: 

char enum flintstones varl; 

The C+ + translator accepts the syntax for char, short, and long 
enumerated types without producing warnings, but it generates C code 
that declares an enum four bytes long. 

Using the sizeof and Comma Operators in 
Preprocessor Directives 

The SAS/C Compiler allows you to use the sizeof and comma (,) 
operators in preprocessor # i f directives, as in the following example: 

I if (sizeof(int) == 2) 
ferror short integers 
lendif 

However, the ANSI Standard does not allow these operators in 
preprocessor directives. Therefore, the compiler produces a warning 
message if you compile your program with the ansi or strict option. 

Note: The C+ + translator does not allow you to use the sizeof 
and comma ( , ) operators in preprocessor # i f directives. 


Using C+ + Style Comments 

In C+ + programs, two consecutive slashes (//) define a comment block 
that extends to the end of the current line. You can use two slashes to 
designate comments in your C and C+ + programs. However, if you 
compile a C program with the ansi or strict options, the compiler 
generates a warning message for these comments. 
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Using Nested Comments 

The ANSI Standard states that a C program cannot have nested 
comments. Therefore, if you enter the comment start sequence (/*) inside 
of a comment, the sequence is not recognized as the beginning of a 
second, or nested, comment. The first comment end sequence (*/) 
terminates comment mode. However, if you specify the comraentnest 
compiler option, as described in Chapter 8, “Compiling and Linking Your 
Program,” the compiler allows nested comments. 

The coramentnest option is not valid with C++. 


Using National Characters in Variable 
Names 

If you do not compile your program with the ansi option, you can use 
accented characters in variable names. 


Using Dollar Signs in Variable Names 

If you compile your program with the dollarok option, you can use 
dollar signs ($) in variable names, except as the first character. 


Using Relaxed Ref-Def Model External Data 

The ANSI Standard defines three methods of how external data should be 
handled. Typical UNIX compilers allow you to declare external variables 
in multiple places, as long as you do not initialize the variable in more 
than one of those declarations. The ANSI Standard refers to this method 
as relaxed reference-definition (or relaxed ref-def). For example, you could 
define the following variable in a header file: 

int i; 

If this header file is included by all files in a project, each file defines a 
variable i. The linker merges all these independent definitions into one, 
creating a relaxed ref-def model for external data. 

Most microcomputer compilers use what is called the strict reference- 
definition model (or strict ref-def) for external data. This model requires 
that one and only one source file in a project define the external variable. 



The remaining files in a project can only declare the external variable. To 
change the definition of variable i to a declaration, use the extern 
keyword as follows: 

extern int i; 

The SAS/C Compiler supports both the relaxed reference-definition 
model and the strict reference-definition model. The default model is strict 
reference-definition. If you want to use the relaxed reference-definition 
model, compile your program with the common compiler option. The 
SAS/C Compiler does not support the ANSI Standard definition of the 
common model. 
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Introduction 

Programming with the SAS/C Compiler is not much different than 
programming in C or C+ + on other compilers. Most of the books about 
the C and C+ + languages that are at your local bookstore are applicable 
to the SAS/C compiler. If you confine your programming to the standard 
features that these books describe, you do not need much specific 
information about how the SAS/C compiler and translator work. 
However, if you want to perform special tasks such as linking with 
assembly language functions, writing I/O drivers in C, or using overlays, 
you may need to know how your C or C+ + program is compiled into 
executable code. 

This chapter describes how your program is translated into executable 
code. This chapter assumes a basic knowledge of object file format as 
described in The AmigaDOS Manual, 3rd Edition (Commodore-Amiga, Inc. 
1991). 

Translating Your C+ + Program 

This release of the SAS/C Development System implements the C+ + 
language by means of a translator that translates C++ to C. The 
translated C code must be compiled with the SAS/C Compiler, which 
produces an object module. Figure 12.1 shows the translation and 
compilation process for a C+ + source program. 
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Figure 12.1 
Translation Process 
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As part of the translation process, your C+ + code is preprocessed. The 
preprocessor is the part of the C++ translator that transforms C+ + 
source code, possibly containing preprocessing directives and operators, 
to C+ + code that does not contain preprocessing directives and in which 
a variety of lexical substitutions or operations may have been performed. 
After the preprocessor step is completed, the translator translates your 
C+ + code into C code. Then, unless you specify the pponly or 
cxxonly option on the sc command line, the compiler compiles your C 
code and creates an object module. Figure 12.2 shows in more detail the 
process the translator goes through to translate and compile your C+ + 
code. 


Figure 12.2 
Expanded Translation 
Process 
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To run only the preprocessor, specify the pponly option on the sc 
command. To run only the preprocessor and translator, specify the 
cxxonly option. If you do not specify the cxxonly option, the 
generated C source file is compiled into an object module, and the 
generated C source file is then deleted. If you specify the link option, 
slink then links the compiled C file into an executable module. 
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The preprocessor conforms to the ANSI Standard for C with the 
addition that it accepts C+ + style comments and it correctly handles all 
C+ + tokens. If you need more detailed information on a specific 
preprocessor feature, refer to the ANSI Standard for C or a C+ + 
tutorial book. 


Compiling Your C Program 

The compiler produces an object module (a . o file) for each assembler, C, 
or C+ + source file. Each object module is organized into hunks. In 
general, a hunk contains the following information: 

□ program code or data. The program code is written into the code hunk. 

The data for your program are written into one of several hunks, 
depending on how the data are declared. For example, data declared 
with the chip keyword are placed in the chip hunk. 

□ external symbol information, including subroutine entry points and 
global data. This information is also referred to as global symbols or 
XDEFs. 

□ relocation records. The linker uses these records to produce a load file. 
A load file is also called an executable module. 

Your program code and data are organized into the following hunks: 
Code hunk 

contains the machine instructions for your program, any string 
constants (if you compile with stringmerge), and anything else that 
the compiler decides is definitely read-only. By default, this hunk is 
named text, but you can change this name with the codename 
option. See the section “Changing Hunk Names,” later in this chapter, 
for more information. 

Near data hunk 

contains all initialized near data, including constants and string 
constants (if you do not compile with the stringmerge option). Near 

data are data that are declared with the near keyword or are 

defined in modules compiled with the data=near option. 
data=near is the default setting, so unless you specify otherwise, all 
of your initialized data are placed in the near data hunk. Near data 
can be accessed by resident programs and libraries. This hunk is 

named MERGED. 

Near BSS hunk 

specifies the amount of memory to allocate for all uninitialized near 
data. The startup code initializes the near BSS hunk to 0. This hunk is 
also named MERGED. 



Chip hunk 

contains all data that are declared with the chip keyword or 

compiled with the datamem=chip option. This hunk is named chip. 
Far data hunk 

contains all initialized far data. Far data are data that are declared 

with the far keyword or are defined in modules compiled with the 

data = f ar or data=faronly options. By default, this hunk is 
named data, but you can change the name with the datanarae 
option. See the section “Changing Hunk Names,” later in this chapter, 
for more information. 

Far BSS hunk 

specifies the amount of memory to allocate for all uninitialized far 
data. The system loader allocates this memory and sets it to zero. By 
default, this hunk is named udata, but you can change the name with 
the bssname option. See the section “Changing Hunk Names,” later 
in this chapter, for more information. 

When you compile your program with the verbose option, the 
compiler produces a message in the following format: 

Module size P-00000000 D=00000000 11=00000000 0=00000000 
F=00000000 UF-00000000 


The letters indicate which hunks were produced for your program: 

P code hunk (your program) 

D near data hunk 
U near BSS (uninitialized data) hunk 
C chip hunk 
F far data hunk 

UF far BSS (uninitialized data) hunk 

The numbers give the size in bytes, using hexadecimal notation, of each 
hunk. If the compiler does not create certain hunks, then the compiler 
either displays zeroes or does not display any numbers for these hunks. 

If you compile your program using a debug option, the compiler 
generates debugging information and writes this information into two 
types of hunks that hold debugging information: 

H—DEBUG contains line numbers, and information about 

variables, typedef s, and structures. H—DEBUG 
hunks are generated by the compiler or the 
assembler. 
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h_symbol contains absolute addresses of global symbols. 

H—SYMBOL hunks are generated by the compiler or 
the linker. 


Linking Your Program 

The linker combines object modules to produce a single executable 
module, shared library, or device. To produce an executable module, the 
linker does the following: 

□ reads each of the object modules. 

□ reads each of the link libraries, if necessary. 

□ writes the contents of the object modules to the executable module. In 

the process, the linker resolves all intra-hunk and near data relocations 
and generates relocation records for relocations that span hunks. The 
linker also combines any hunks in the object module that have the 
same name. For example, the linker merges all near BSS hunks and 
appends them to the MERGED data hunk. 

□ generates overlay nodes, if required. 

□ copies segments of the library files that are referenced by the program 
to the executable module. If those segments reference any symbols, 
then the library segments that define those symbols are also copied to 
the executable module. This process is repeated until all symbols are 
resolved. 

n produces data for the overlay supervisor, if required. 

□ sets up the ctors and dtors arrays to ensure that 

autoinitialization and autotermination functions will be called correctly. 

□ produces a map file and cross-reference tables, if requested. 

If you are not using overlays, all of the hunks in the executable module 
are contained in one primary node (also called the root node). If you are 
using overlays, the executable module also contains a node for each 
overlay. 


Running Your Program 

When you run your program, the AmigaDOS system loader copies the 
executable module into memory. As it copies the executable module, the 
loader: 

d resolves the remaining relocations. 

□ allocates and zeroes the memory required for uninitialized far data (the 
far BSS hunks). 
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There are two other program components, the stack and the heap, that 
are not part of the executable file but that form an important part of the 
final executing program. 

Stack Area The stack is a writeable memory area whose size is set by the AmigaDOS 

stack command or by the external long integer stack . The default 

stack size is four kilobytes. This stack is used during function calls for 
saving registers and passing arguments. Within a function, automatic 
variables are allocated from the stack. 

For many C programs, a four-kilobyte stack is adequate. If your 
program requires more stack space, see Chapter 11, “Using SAS/C 
Extensions to the C and C+ + Languages,” for information on allocating 
additional stack space. 

Heap Area The heap is a writeable memory area whose size is determined by the 
following: 

□ the dynamic memory needs of the program 

□ the amount of memory installed on the system 

□ the amount of memory that is currently being used. 

All memory allocation routines such as malloc return memory from 
the heap. If the heap is not large enough to handle a request, the library 
function calls on the AmigaDOS system to provide more memory. 


Changing Hunk Names 

If you change the names of any of the hunks produced by the compiler, 
keep in mind the following: 

□ All hunks with the same name are merged by the linker. 

□ The system loader may have trouble finding enough contiguous 
memory to load very large hunks. 

The following hunk section names are reserved: 

NTRYHUNK 

Your load file may contain only one NTRYHUNK hunk. The linker 
places this hunk first in the executable module. Usually, this name is 
used only as the name of overlay manager’s code hunk. 

MERGED 

This name is used for the near data section. All hunks with this name 
are merged and moved into the root node. The startup code initializes 
register A4 to point to this hunk. 
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—NOMERGE 

Hunks with this name are never merged with other hunks, including 
other hunks named —NOMERGE. They each occupy a single, separate 
hunk in the load file. 


Addressing Data 

If you compile with the default options, your program code and data are 
referenced with one of three different types of addresses: 

□ 16-bit address relative to the program counter. 

Items in the code section are referenced with 16-bit PC-relative 
addresses. 

The 16-bit offset is a signed value that is added to the current 32-bit 
address in the program counter. Therefore, if a function is more than 
32 kilobytes above or below the point at which it was called, the linker 
constructs an absolute branch instruction within the 32-kilobyte range 
and routes the call through that branch. 

□ 16-bit address relative to register A4. 

When you link your program, all data in the near data and near BSS 
hunks are merged into one near data section. When you run your 
program, the startup module loads the address of the near data section 
into register A4, and this section is referenced with 16-bit A4-relative 
addresses. 

Using 16-bit addresses produces code that is smaller and faster 
because each load or store instruction requires only four bytes. 
However, because near data are referenced with 16-bit addresses, you 
are limited to 64 kilobytes of near data (32k for shared libraries and 
devices). If you have a very large data structure or array, consider 
placing it into the far section or allocating it dynamically. 

□ 32-bit absolute address. 

Items referenced with 32-bit addresses can be located anywhere in 
memory. Items in the far and chip data and far BSS sections are 
referenced with 32-bit absolute addresses. 

Using 32-bit addresses produces code that requires more space and 
takes longer to run because each load or store instruction requires six 
bytes. However, because far data are referenced with 32-bit addresses, 
there is no limit on the amount of far data that you can declare in your 
program. 

chip data are always referenced with a 32-bit pointer and are 
therefore considered non-reentrant. However, most chip items are picture 
image structures that are referenced in a read-only mode. If your 
program uses chip data as read-only, your program is still re-entrant. 



Declare read-only chip data with the const keyword if you want to avoid 
linker warnings when linking with cres.o or creating a library or 
device. 

Chip data can be accessed by the Amiga custom chips such as graphics 
chips and sound chips. Chip data are loaded into chip memory, which is 
the lowest 51 2K to 2M of system memory, depending on the version of 
the hardware that you are running. 

You can modify how your program code and data are accessed by: 

□ declaring individual data items with the appropriate keyword: 

chip, near, or far 

□ compiling with the string sect ion option 

□ compiling with the absf uncpointer option 

□ linking with the smallcode and/or smalldata options 

□ compiling with the code and/or data options 

□ compiling with the datamem, coderaem, and/or bssmera options 

□ linking with the chip or fast option. 

For more information on the chip, near, or far keywords, 

see Chapter 11, “Using SAS/C Extensions to the C and C+ + 

Languages.” For more information on the compiler and linker options, 
see Chapter 8, “Compiling and Linking Your Program.” 


Understanding Data Types and Sizes 

The following sections describe how various data types are represented 
on Amiga hardware. 

By default, all arithmetic objects are signed, and therefore, they can 
take on values less than zero. However, if you specify the 
unsignedchar option, the compiler treats all char objects as 
unsigned. 

You can specify that an integral object (char, int, short or long) 
be signed or unsigned by declaring the object with the signed or 
unsigned keyword, as in the following example: 

unsigned long x; 

The following table lists the sizes, minimum values, and maximum 
values of each of the signed and unsigned data types. 
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Type 

Bytes 

Minimum 

Maximum 

signed char 

1 

-128 

+ 127 

unsigned char 

1 

0 

255 

signed short 

2 

-32,768 

+32,767 

unsigned short 

2 

0 

65,535 

signed int 

4 

-2,147,483,648 

+ 2,147,483,647 

unsigned int 

4 

0 

4,294,967,295 

signed long 

4 

-2,147,483,648 

+2,147,483,647 

unsigned long 

4 

0 

4,294,967,295 

float (IEEE) 

4 

3.402E-37 

3.402E+38 

double (IEEE) 

8 

2.222E-308 

1.797E+308 

float (FFP) 

4 

5.421 E-20 

9.223E+18 

double (FFP) 

4 

5.421E-20 

9.223E+18 


Note: In the AmigaDOS environment, pointers are always 4 bytes in 
length. Also, the values for signed int and unsigned int in this 
table are the values if you do not specify the shortint option. 

The default size of an int on Amiga hardware is four bytes. However, 
if you are not using C+ + , you can set the size of an int to two bytes by 
compiling your program with the shortint option. 

When the compiler is calculating the value of an expression using 
variables of different data types, the compiler performs some automatic 
type promotions and then does the calculation using the data type of the 
widest operand. The widest operand is the operand that can contain the 
largest positive number. For example, suppose you may have a 
calculation involving a variable of type char and a variable of type 
unsigned long. The char is automatically promoted to int, so the 
calculation now involves an int and an unsigned long. The int is 
then promoted to unsigned long under the wider type rule. 



These rules can dramatically affect your code. In the example 
calculation, the char is signed. If it holds a -1, for example, the -1 is 
promoted to int, yielding -1. The int is then promoted to unsigned 
long, yielding a very large positive number. 

These implicit conversions follow the conversions described in the 
ANSI C Standard in Section 3. 2. 1.5, “Usual Arithmetic Conversions.” 

C+ + behaves the same as C in this respect. The following table lists the 
type to which the various data types are converted. 


Operand Type 
char 

unsigned char 
short 

unsigned short 
int 

unsigned int 
long 

unsigned long 

float 

double 


Conversion Type 

int 

int 

int 

int 

int 


unsigned int 
long 

unsigned long 

float 

double 


Note: As previously stated, if you compile your C program with the 
shortint option, integers are two bytes long. Then, if you cast the 
result of an expression involving two integers to another type, you do not 
get the results you might expect. For example, you could have the 
following code in your program: 


long 1; 
int i=32000; 
int j=32000; 

1 = (long) (i * j ) ; 


If you compile this code with shortint, i and j are not promoted to 
long before the expression is evaluated. The result of the expression is 
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too long to fit into a short integer. The overflow is cast to a long, which 
gives the wrong result. To correct the problem, explicitly cast i or j to a 
long, as in the following example: 

1 = (long)i * j; 

Storing Data 

In the C Language, each data object is associated with a storage class that 
is either declared with a keyword (auto, extern, static, or 
register) or determined by the context in which the declaration 
occurs. 

An object’s storage class determines the location where the object is 
stored and the scope of the object. Therefore, the storage class of the 
objects in your program can affect your program’s size and performance. 

The following list describes where objects are stored, based on their 
storage class: 

External 

External objects are stored in a global data area (one of the near, near 
BSS, far, far BSS, or chip sections). 

Static 

Static objects are stored in a global data area (one of the near, near 
BSS, far, far BSS, or chip sections) unless you specify the 
stringsection option. If you specify stringsection, data 
declared static const are placed in the code section. 

Automatic 

Storage for automatic objects is allocated on the stack during the 
execution of the function in which the object is defined. When the 
function returns, the automatic storage is freed. 

Formal 

An object has the storage class formal if it is a parameter (or 
argument) to a function. Storage for formal objects is allocated on the 
stack during the execution of the function in which the object is 
defined. 

Register 

Register variables may be stored in registers, or they may be stored on 
the stack. If you run the global optimizer, the optimizer allocates all 
register variables and ignores the register keyword. If you do not 
run the optimizer and you specify the noautoreg option, only those 
variables you declare with the register keyword are stored in 
registers. If you compile with autoreg, the code generator decides 
which additional variables are stored in registers. 



198 



















199 


Writing Portable C Code 


199 Introduction 

199 Compiling Your Program 

200 Writing Your Program 

201 Dealing with Data Type Sizes 

201 Determining Structure Size and Padding 

202 Writing Structures to a Disk File 

205 Using Narrow 7y pes in Pre-ANSI Function Declarations 

206 Using Incomplete Structure Tags 


Introduction 

The C language has many characteristics of a portable language, but some 
features of the C language are dependent on the type of machine on 
which the program is running. However, you can write programs that 
run on many different machines if you follow some guidelines when 
compiling and writing your program. 

The following sections describe actions you can take to improve the 
portability of your programs. 

Note: Much, but not all, of the discussion in this chapter also applies 
to C+ + programs. 


Compiling Your Program 

You can compile your program with the strict and/or ansi options. 
These options enable many warnings that identify possible problems in 
your code that may cause errors if you port your code to systems other 
than the Amiga system. For example, the following code does not 
generate any warnings by default: 

void fund (long); 

void func2(void) 

1 

short s= 0 ; 
fund (s) ; 

1 



However, if you compile this code with the strict option, the compiler 
displays the following message: 

Warning 120: Integral type mismatch: possible portability problem 
Expecting "long", found "short" 


Writing Your Program 

If you use only library functions and language features that are defined in 
the ANSI C Standard (American National Standard for Information 
Systems — Programming Language Q, your program should compile 
without modification on any system that has an ANSI-compliant C 
compiler. However, there are many features of the C language that are 
implementation-defined. Even if your program compiles without 
generating errors, it may not run as you expect. See Appendix 3, 
“Implementation-Defined Behavior,” for more information. 

To help you identify non-portable functions and macros in your 
program, you can define the _STRICT_ANSI preprocessor symbol. You 
can define this symbol by entering define _STRICT_ANSI= 1 in the 
sc command or by entering the following statement in your C source file 
before any header files are included: 

Kdefine _STRICT_ANSI 1 

If you define _STRICT_ANSI, the header files that are defined by the 
ANSI C Standard (such as errno . h and stdio . h) do not define any 
prototypes or macros for functions not permitted by the ANSI C 
Standard. If your program calls a non-ANSI function, the compiler issues 
a warning message because the function has no prototype. For more 
information on the _STRICT_ANSI symbol, refer to SAS/C Development 
System Library Reference. 

In addition, if you follow a few additional guidelines, you can avoid 
most portability problems. The following list contains some guidelines 
that can help improve the portability of your program. 

□ Do not assume data type sizes are standard. 

□ Do not assume structure padding or size is standard. 

□ Be careful when writing structures to disk. 

□ Do not use narrow types in old-style definitions. 

□ Be careful about using incomplete structure tags. 

n Do not write pointers to files. Pointers are useless outside of the 
invocation of the program that generates them. 
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□ Do not assume that you know whether char variables and bitfields are 
signed. 

□ Do not assume that you know the placement of bitfields within 
structures. 

The following sections discuss these guidelines in more detail. 

Dealing with Do not assume that the int data type is always a particular length. The 
Data Type Sizes ANSI C Standard specifies that the int type must be at least as long as 
the short type and that the short data type must be able to hold 
numbers in the range 32767 to -32768. Therefore, portable code should 
never store numbers larger than 32767 or smaller than -32768 in an 
int. Use long for larger numbers. 

The default size of an int on the Amiga system is four bytes. On other 
systems (such as the IBM PC), the size of an int is two bytes. The 
SAS/C Compiler treats the data types int and long as the same data 
type. However, you can set the size of an int to two bytes by compiling 
your program with the short int option. If you compile with 
shortint, the compiler treats the data types int and short as the 
same data type. 

If you port your program to a system that uses two-byte integers and 
you do not compile with the shortint option, you may receive 
unexpected results. For example, when passing parameters on the Amiga 
system, short and char variables are silently promoted to ints. 
Therefore, any function declared as receiving a long does not produce a 
warning if you pass a short or char to the function. To receive an 
appropriate warning message, you can enable warning 120 by compiling 
with the warn=120 or strict compiler options. 

Declaring an object as signed is usually redundant, because integral 
objects are signed by default. However, judicious use of the signed 
keyword can enhance your program’s portability, because some compilers 
may make char declarations and bitfields unsigned by default. 


Determining Even though the Motorola 68000 processor uses byte addresses, it 
Structure Size requires that 16-bit and 32-bit data items be aligned on even addresses, 
and Padding That is, the lowest bit of the address must be zero. Because of this 

requirement, the SAS/C Compiler inserts dummy bytes (called padding) as 
necessary to align integers, floats, doubles, and pointers. 

For example, in the following structure, the SAS/C Compiler adds one 
byte between the structure members a and 1. 


struct misc 

I 


char a [3]; 
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); 


If the dummy byte was not added, the long structure member would 
end up on an odd boundary and an addressing exception would result. 

On other systems, an ANSI-compliant C compiler may add more or less 
padding as required. Many computers require that long integers fall on 
four-byte boundaries, so the compiler would add three bytes of padding 
instead of one. 

Because of these alignment requirements, data structures may be 
different sizes on different machines. Do not assume that you know the 
size of a structure based on the fields declared in it. Use the sizeof 
operator to determine the size, and do not depend on sizeof to return 
the same result on different machines. Using the previous example, the 
expression sizeof (struct raise) has a value of 8, and the following 
expression has a value of 7: 

sizeof (misc. a) + sizeof (misc.l) 

Writing If you try to write structures to a disk file on one system and read the file 
Structures to a on another system, you may get different values. This problem may be 
Disk File caused by differences in structure padding (as described under 

“Determining Structure Size and Padding”) or by differences in the 
representations for characters, floating-point numbers, or integers. For 
example, the following program writes a structure to a file: 

finclude <stdio.h> 
main( ) 

( 

FILE *fp; 
struct 
I 

char x; 
short y; 

) record; 

fp = fopen( "testf ile" , "wb" ) ; 
record. x = 3; 
record. y = A; 

fwrite( Srecord, sizeof (record) , 1 ,fp) ; 
fclose(fp) ; 
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If you compile and run this program using the default compiler options, 
the file testfile contains four bytes in the following order: 03 0 0 00 
0 4. However, if you compile and run this program under MS-DOS, 
which uses the Intel family of processors, the file contains 03 04 00 . 
The reasons for the different values are as follows: 

□ The SAS/C Compiler inserts a padding byte so that integer y is 
correctly aligned. The Intel processor does not require this padding. 

□ The Motorola processor writes integers from the high byte to the low 
byte, and the Intel processor writes integers from the low byte to the 
high byte. 

The following paragraphs describe some simple rules that you can use 
to make your structures more portable between the Amiga computer and 
most other computers. These guidelines help you produce a structure that 
your program can write to disk and then read in a single operation. 

These guidelines are not guaranteed to work in all cases, but they do gain 
you limited ability to interchange files between various computers. 

The computer to which you are porting your program must do the 
following: 

□ Use the same floating-point format for doubles that you are using on 
the Amiga system (FFP if the math=f fp option is specified, IEEE for 
all other formats). 

□ Use the ASCII character set. 

□ Use the same sizes for data types: 

char 1 

short 2 

long 4 

□ Store integers using the same bit pattern that the Amiga system does. 
The structure to be written must follow these rules: 

o The structure can contain only the following data types: 

Type Length 

char 1 

short 2 

float 4 

long 4 

double 8 (or 4 if you compile with math=f fp) 

Do not use ints or any pointer types in the structure. 

□ Structures or unions may contain other structures or unions that 
follow these rules. 

□ Each field must be placed at an offset relative to the start of the 
structure that is an exact multiple of the field’s size. 



□ A nested structure or union must be placed at an offset that is an exact 
multiple of the largest simple arithmetic type occurring in any of its 
fields, including the fields of any substructures or subunions. 

□ If the structure or any of its substructures contains a double, the 
structure must contain extra fields as needed to ensure that its total 
size is an exact multiple of the size of a double. If it does not contain 
a double, it must contain extra fields to ensure that its total size is an 
exact multiple of four. 

For example, you cannot port the following structure between systems: 
struct NOTDISKABLE /* Non-diskable structure »/ 

I 

char a; 
double d; 
short s; 
long 1; 

char name[ 27] ; 
struct XXX 
( 

char a, b; 

1 foo[ 11]; 


To make the previous structure portable between systems, you must 
declare the structure as follows: 


struct DISKABLE 

I 

char a; 

char dummy1[7]; 
double d; 
short s; 
short dummy2 ; 
long 1; 

char name [ 27] ; 
char dummy2 | 5 ] ; 
struct XXX 


/* Diskable version of same structure */ 

/* following double needs 8-byte offset */ 

/* following long needs «-byte offset */ 

/* following structure needs fl-byte offset */ 


char a, b; 

char dummy3(2]; /» Pad to multiple of H bytes */ 
) fooj 11]; 

char dummy*! [ 4 ] ; /* Pad to multiple of 8 bytes */ 
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Using Narrow 
Types in 
Pre-ANSI 
Function 
Declarations 


The ANSI C Standard states that function definitions should specify the 
data type of each parameter, as in the following example: 


/* ANSI C Standard prototype-style definition */ 
void newfuncf short s, float f) 

( 


) 


Pre-ANSI C accepted function definitions in the following form: 

/* Pre-ANSI old-style definition */ 
void oldfunc(s, f) 
short s; 
float f; 

( 


1 


The ANSI C Standard default argument promotion rules (described in 
Section 3.3.2.2 of the ANSI C Standard) differ for functions defined with 
prototype-style definitions and functions defined with old-style definitions. 
You may get incorrect results on ANSI-conforming compilers if you use 
ANSI standard prototypes and old-style function definitions for the same 
function. You can avoid this problem by not using narrow data types 
(char, short, and float) in function prototypes and definitions. 

The ANSI C Standard says that functions defined with old-style 
definitions and no prototypes must receive all char and short 
parameters as if they were type int and receive all float parameters 
as type double. The incoming parameters are then converted to the 
appropriate shorter type. Functions defined with new-style definitions are 
free to receive narrow types as declared. Unfortunately, the caller of the 
function does not know whether the function is defined with a prototype- 
style definition or with an old-style definition. 

The ANSI C Standard does not define what happens if you declare a 
function using an old-style definition but also include an ANSI standard 
prototype for the function. To make more programs work as expected, the 
SAS/C Compiler treats such definitions as if they were new-style 
definitions. 
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If you do not port your program to a system other than the Amiga 
system, you should not encounter any problems with narrow types unless 
the following situation occurs: 

The caller has a prototype for a function that says float. The 
called function does not include the prototype and has an old- 
style definition that says float. 

The data types char and short do not cause problems on the Amiga 
system because they are passed as if they were type int for both old- 
style and prototype-style function definitions. 

To help identify problem situations, you can enable the following 
warnings: 


Warning Description 

165 This message identifies narrow types that have been used 

in function prototypes. You can enable this warning with 
the warn= 1 65 option. 

176 This message identifies arguments that have been 

promoted using the default argument promotion rules 
and, as a result, conflict with the prototype given for the 
function. You can enable this warning with the strict, 
ansi, or warn=176 option. 

179 This message identifies narrow types that have been used 

in an old-style function definition. You can enable this 
warning with the strict or warn=179 option. 


Using Incomplete An incomplete structure tag is a structure tag (or name) that has not yet 
Structure Tags been defined. The ANSI C Standard allows you to refer to structures by 
name before they have been defined, as long as you only declare pointers 
to the structure and do not attempt to dereference these pointers. 

Incomplete structure tags can cause problems if they occur in a 
function prototype. The ANSI C Standard allows incomplete structure tags 
in function prototypes but states that the incomplete tag goes out of scope 
at the closing parenthesis of the prototype. Any declaration of the 
structure later in the program is not associated with the incomplete tag 
used in the prototype and is considered to be a completely different 
structure. 

If you define the function later in the program, an ANSI-conforming 
compiler may issue an error message, and your program may not 
compile. 
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For example, many ANSI-compliant compilers generate an error 
message for the following code, claiming that the type of the parameter 
does not match the type declared in the prototype. 

void func(struct F00 *); /* Incomplete tag F00 */ 

struct F00 

{ 

int x, y, z; 

); 

void func( struct F00 *parm) /* Error here! */ 

1 

1 


If you move the definition of struct FOO before the prototype, this 
code compiles without problems. 

To help you identify incomplete tags, you can enable the following 
warnings: 


Warning Options 

148 This warning identifies any use of incomplete tags. You 
can enable this warning with the warn= 1 <48 option. 

149 This warning identifies incomplete tags that are used in 
function prototypes. You can enable this warning with 
the strict or warn=149 option. 
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Introduction 

This appendix describes the solutions to some of the most common 
problems for which users call the Technical Support Division. 

Before calling the Technical Support Division, read the re ad. me file 
on disk 1 carefully. (The read. me file is also copied to the directory into 
which you install the product if you installed the SAS/C Development 
System on a hard drive.) This file contains errata for the documentation 
and information about any feature that may have been added after the 
documentation went to press. 


Resolving Undefined Symbols 

When I compile and link, I get messages reporting Undefined 
Symbol : _C Xnnn and saying that the proper math library has not 
been included. 

In your program, you have accessed floating-point math routines, but 
you have not linked with the appropriate math library. Specify the 
appropriate math option for the library with which you want to link, 
such as math=standard. If you are using the link option to link 
your program, the compiler links with the correct math library. If you 
call the linker separately from the compiler, you must specify the 



correct math library in the slink command after the lib keyword. 
Refer to SAS/C Development System Library Reference for more 
information about math libraries. 

I am getting BLTN and/or CXERR errors, and I am using math libraries 
and header files. 

You may be including the math header files for one type of floating- 
point format and linking with libraries for another type of floating- 
point format. For example, you may be including m6888 1 .h and 
linking with scmf fp. lib. Different floating-point formats are 
incompatible and should not be mixed. Make sure that your included 
header files match the math library with which you are linking. 

If you find no problem with the compatibility between your header 
files and your math library, contact the Technical Support Division. 
When I link my project, I get undefined symbols. This code worked in 
Release 5.10. 

Some of the library symbol names have been changed to comply with 
the ANSI C Standard for symbol names. The ANSI C Standard states 
that any symbols that are not mandated by the Standard must begin 
with an underscore and a capital letter or two underscores. 

When you compile your program, the compiler adds an additional 
underscore to the beginning of any symbols defined in C code. 
Therefore, a C symbol with two underscores has three underscores 
when the linker finally sees the symbol. 

If your code refers to a symbol that has changed names from 
Version 5 to Version 6, the linker may produce an undefined 
symbol message when you link your program. If you receive this 
message, first check the SAS/C Development System Library Reference 
for different versions of the symbols with different numbers of 
underscores. Remember, the linker reports one more underscore on 
the symbol than the SAS/C Development System Library Reference 
shows. 

Change your C code to refer to the new name for the symbol as 
described in the SAS/C Development System Library Reference. If this 
solution is not practical because of the number of references to the 
symbol, you can solve this problem in one of two other ways: 

□ Use the define option on the sc command or a #def ine 
statement in a header file to define the old name to the new name. 

□ Use the define option on the slink command to force all 
references to one of the names to refer to the other. If you define 
the item in your code (in other words, you declare it without the 
extern keyword), you should use the define option to define the 
new name (used by the library) to the old name (used by your 
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code). If you declare the item with the extern keyword and, 
therefore, use the library definition for the item, use the define 
option to define the old name (used by your code) to the new name 
(used by the library). 

One very common technique used in Version 5 was to declare the 
main routine of your program as _main instead of main to bypass 
the overhead required to set up stdio and argument parsing. You 
should change this name to — main and add the keyword 

stdargs to be compatible with Version 6. If you do not change 

this name, the linker issues a message saying that the symbol _main 
is undefined. (Remember, the linker puts in an extra underscore, so 
the symbol it is really looking for is ma i n). 


Fixing Compilation Errors 

I have installed my compiler correctly, but I keep getting the message 
se not found or sc not found whenever I try to do anything. 
Your s : user-startup may not be set up correctly. The installation 
program places three assign statements and the path statement at 
the end of your s : user-startup file. If you are invoking any 
programs that create a new Shell (such as PopCLI) in your 
s : user-startup file before the path sc:c add statement, sc : c 
may not be in new shells created by the program. To correct the 
problem, move the three assign statements and the path statement 
above any calls to programs that create a new Shell. 

If you are running under AmigaDOS Version 1.3, you may have a 
different problem. The installation program places the necessary 
assigns in a file named s : user-startup, which is called from 
s : startup-sequence. You may have to edit 
s : startup-sequence and make some changes. See Chapter 1, 
“Installing Your SAS/C Development System,” for information on 
modifying your startup file. 

After switching to Version 6, my old programs will not compile, or 
they compile with a lot of warning messages. Why is this happening 
and how can I fix it? 

There are two solutions: 

□ In Version 6, the compiler assumes that your code will provide 
prototypes for all functions. (In Version 5, you had to specify the 
-cf option for the compiler to identify missing prototypes.) If your 
code does not define prototypes for all functions, the compiler may 
produce several warning 100, 154, and 161 messages. Specify 
ignore - 100+154+161 to suppress these warnings, or use the 



genprotos option to generate prototypes for your functions and 
# include the resulting header file. 

□ Unlike previous versions, the header files and libraries for 
Version 6 of the SAS/C Compiler are ANSI-compliant. The ANSI 
specifications affect both ANSI and non-ANSI functions and data 
names, so some non-ANSI functions and data names have also 
changed. 

Convert your program to use the new ANSI-compliant libraries 
and headers. For any functions mentioned in error messages, read 
the description of the function in the SAS/C Development System 
Library Reference. This reference manual describes the parameter 
list, return value, and necessary header files required by each 
function. Make sure that you are including the correct header for 
each of the SAS/C or AmigaDOS functions that you are calling. 

When I compile, the options I requested do not act as expected. 

When you compile your program, whether you compile from the Shell 
or the Workbench screen, the compiler looks for an scoptions file 
in your current directory. If it does not find one, it looks for the file 
ENV: sc/ scoptions. If it finds either of these files, it uses any 
additional options specified in the file. You can run the scopts utility 
or edit the scoptions file to review the options specified in these 
files. If you want to prevent the compiler from reading the options 
specified in any scoptions file, specify the resetoptions option 
as the first option in the sc command. If your program then runs as 
expected, you have a problem with the options that you have specified. 
If you specify the verbose option, the compiler tells you the location 
of the scoptions file used. 

During compilation, I get the message semi-colon expected in a 
header file. 

Check for extra characters at the beginning of your file in front of 
your # include statements or in one of your header files. You may 
have accidentally pressed a key while starting the editor. 

I keep getting the message Error 25: Modifiable lvalue 
required, but I am declaring all my variables for a function just like 
it says in the library reference manual. 

Do not include the const keyword in your declarations. The SAS/C 
Development System Library Reference contains many variables defined 
with the const keyword, especially pointers to strings. This keyword 
is required by the ANSI C Standard and indicates that these variables 
will not be modified in the library function to which they are passed. 
The const keyword is present in the parameter list of the prototype 
that is found in the associated header file. This prototype, not the 
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declaration you should include in your program, is what is described 
in the synopsis for each function in the SAS/C Development System 
Library Reference. Use the synopsis as a guideline for your 
declarations, but do not include the const keyword. 

Using CodeProbe 

I do not get all of the information I expect out of CodeProbe, or 
CodeProbe does not know about variables and functions it should 
know about. 

You may not be compiling with the correct debug option. If you are 
compiling with nodebug or debug=line, try compiling with 
debug=sf. For a complete description of each debug option, see 
Chapter 8, “Compiling and Linking Your Program.” 

CodeProbe does not work if I double-click on the Debug icon from the 
WorkBench screen. 

To invoke CodeProbe from the WorkBench screen, click on the Debug 
icon. Then, hold down the Shift key and double-click on the icon for 
your program's executable module. 


Using Formatted Print Functions 

printf (or sprintf, f printf, and so on) does not print the correct 
values. 

This problem can happen for the following reasons: 

□ You are asking printf to print a variable, but the variable 
conversion characters are incorrect. For example, you are trying to 
print a long integer using %d as the conversion character. A 
long variable requires a Sid if the shortint compiler option is 
active. Often, if you have one conversion character wrong, the rest 
of the line you are printing is also incorrect. Check your entire 
printf (or fprintf, etc.) format string carefully. 

□ You are trying to print a float or a double, but you have not 
linked with the proper math library. You must link with a floating 
point math library to perform any floating point operations. If you 
are linking with a floating point library, make sure that it is 
positioned in your slink command line before sc . lib so that the 
linker can find the correct version of printf. If you specify the 
link option in the sc command, the compiler links the libraries in 
the correct order. 

□ You are linking with amiga .lib before the math library and 

sc . 1 ib. You should specify amiga . 1 ib as the last library in the 



slink command. If you specify the link option in the sc 
command, do not specify amiga . lib. 


Using getchar 

getchar does not work as expected. 

Input and output on the Amiga system are buffered. On most other 
systems, getchar immediately gets a character from stdin (usually 
the keyboard). However, the CON : device on the Amiga system buffers 
its input, so your program does not actually read any characters until 
you do one of the following: 

□ fill up the console input buffer 

□ press Return 

□ enter the Amiga End-of-File character, Ctrl-\. 

The SAS/C Development System libraries include two functions that 
you can use to deal with this problem: 

getch gets a character from the console in RAW mode. The 
character is returned as soon as the user types it. 
rawcon turns RAW mode on and off. rawcon( 1 ) sets the console 
into RAW mode, rawcon ( 0 ) restores the console to non- 
RAW mode. 

When the console is in RAW mode, any characters typed by the user 
are passed immediately to the application. 

getch returns a single character from stdin just like getchar, 
but getch gets the character in RAW mode. If your console is not in 
RAW mode, using getch is equivalent to the following sequence: 

rawcon ( 1 ) ; 
c = getchar ( ) ; 
rawcon) 0) ; 

If your console is in RAW mode, getch is equivalent to getchar. 

For more information about getchar, refer to SAS/C Development 
System Library Reference. 
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Getting Incorrect Results from Function 
Calls 

My program compiles and links without errors, but I am getting the 
wrong results from some of my SAS/C function calls. 

You can get incorrect results from a function if you do not include the 
correct header files for the function you are calling. The header files 
contain prototypes for each of the SAS/C functions, as well as 
definitions for many common data structures required by these 
functions. By including the correct header file, you are providing the 
compiler with a prototype for the SAS/C functions you call. 

The ANSI C Standard requires that the compiler assume that 
functions that are called without the previous inclusion of a prototype 
return an int. For example, this means that if you call atof , which 
returns a double, without including math.h, the compiler assumes 
that atof returns an int and allocates only 4 bytes for the return 
value. When atof is called and the correct 8-byte double value is 
returned in the 4-byte space allocated for it, the value appears to be 
incorrect. 

You may be including the incorrect header file for one of these 
reasons: 

□ In Version 6, the prototype is contained in a different header file 
than in Version 5. For example, in Release 5.10, the function atof 
was included in math.h. In Version 6, the atof prototype was 
moved to stdlib.h as required by the ANSI C Standard. Check 
the SAS/C Development System Library Reference for the correct 
header file for the functions that you are using. 

□ You may be including the right header file from the wrong 
directory. For example, the include :dos directory contains many 
header files with the same names as those in the root level 
include: directory. However, these header files are AmigaDOS 
header files and not ANSI header files. The AmigaDOS header files 
do not contain the necessary prototypes and data declarations. For 
example, you may be including dos/stdio.h instead of 

stdio . h. Do not substitute header files from the include : dos 
directory for standard headers. 

a You may be including header files from the proto directory instead 
of those in the root level include: directory. Although the files in 
the proto directory do contain prototypes for many of the SAS/C 
functions, these files are intended to be included in addition to the 
standard header files, not in place of them. Do not use header files 
in include: subdirectories as substitutes for the root level header 
files. 



Crashing the Machine 

My program compiled and linked without any errors, but when I run 
it, my machine crashes. What am I doing wrong? 

The following list contains some of the more common errors that 
crash programs. Most of these errors are caused when your program 
accesses memory that it is not supposed to access. 

□ You have declared a pointer to an array or structure for which you 
have not allocated memory. This mistake is especially easy to make 
when calling functions that fill the array or structure with 
information, such as the f stat, lstat, and stat functions. 

To correct this problem, call raalloc or calloc to allocate the 
appropriate amount of memory for the array or structure. 

□ You have assigned an inappropriate value to a pointer, so the 
pointer no longer points to a valid memory space. This type of error 
can be quite difficult to track down. You may want to run 
CodeProbe, Enforcer, or the Mungwall program if you think these 
types of errors may occur. Enforcer and Mungwall are programs 
that detect memory errors. They are available from Commodore 
Applications and Technical Support (CATS) and are shipped with 
Version 6. 

□ You have specified the nostackcheck option and are overwriting 
your stack. Do not specify nostackcheck until your program is 
completely debugged. The stackcheck option is the default unless 
you are creating a shared library using the libcode option. 


Using The asctime Function 

I am using the asctime function to convert the time to Greenwich 
Mean Time (GMT) correctly, but the result is exactly an hour (or two 
or three...) off. 

Your machine is probably set to the default time zone, Central 
Standard Time (CST), and has not been set to your actual time zone. 
To correct the problem, set your machine’s time zone environment 
variable to your actual time zone with the following AmigaDOS 
command: 

setenv TZ =your-time-zone 

For your-time-zone, enter your zone's standard three letter 
abbreviation followed by the number of hours difference between your 
time zone and Greenwich Mean Time. For example, for Eastern 
Standard Time, the command would be as follows: 
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setenv TZ=EST5 

You can also initialize the _TZ variable as described in the SAS/C 
Development System Library Reference. Initialize the _TZ variable with 
the same time zone data as you would enter with the AmigaDOS 
command described above (for example, EST5). 

Note: The AmigaDOS environment variable does not have a 
leading underscore that the SAS/C data name has. 


Managing the Standard I/O Window 

An annoying window opens when I run my program from the 
Workbench screen. How do I get rid of this window? 

The SAS/C startup code opens this window when you run a program 
from the Workbench that uses stdin, stdout, or stderr. If 
necessary, you can change the attributes of this window. For 
information on managing this window, see Chapter 9, “Running Your 
Program from the Workbench Screen." 


Linking Resident Programs or Creating 
Resident Libraries 

I get the message absolute reference to name from the linker. 
You are linking a resident program with the cres . o startup module, 
or you are creating a resident library or device, but the linker detected 
a reference to an absolute symbol. Make sure that the symbol being 
referenced is not being modified. 

If the item is not being modified, then you can ignore the warning 
message, or you can suppress the message by adding the const 
keyword to the definition of the symbol. 

If the symbol is being modified, you cannot link with cres . o or 
with the shared library startup module you are using. 


Writing Replacement Functions for SAS/C 
Library Functions 

I wrote a replacement function for one of the SAS/C library routines, 
but the library routines don’t seem to be using my replacement 
function. 

If you write a function that has the same name as a C library function, 

you need to add the regargs keyword to your function or 

compile with the parms=both or parms=register option. For 



example, you may want to replace the SAS/C library function malloc 
with your own version of malloc. If you compile with the 
parras=stack option or define your version of malloc with the 

stdargs keyword, then two versions of malloc are linked into 

your executable. If you use other SAS/C library functions that call 
malloc, these functions use the version of malloc in the SAS/C 
libraries. However, your functions that call malloc use your version 
of malloc. To make sure that all calls to malloc are using your 

version of malloc, define your version with regargs or compile 

with the parms=both or parms=register option. 

For information on using registerized parameters, refer to the 

description of the regargs keyword in Chapter 11, “Using SAS/C 

Extensions to the C and C+ + Languages," and the description of the 
parameters compiler option in Chapter 8, “Compiling and Linking 
Your Program.” 


Eliminating Informational Messages 

How can I turn off all of the informational messages the compiler and 
linker produce every time I compile and link? 

You can specify the following options on the s c command line: 

sc nover link filename . c 


Turning Off Control-C 

How can I turn off Control-c checking in my program? 

To turn off Control-C checking, you can either compile your program 
with the nocheckabort option, or you can include the following 
function prototype and definition in your code: 

void regargs chkabort(void) ; 

void — regargs — chkabort( void) 

I 

1 


This code replaces the function normally called for a Control-C with a 
function that does nothing. 

To retain checking for Control-C, but to change the action taken 
when Control-C is pressed, include the following: 
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void regargs _CXBRK( void) ; 

void regargs -CXBRK(void) 

I 

/* your-code-here */ 

) 


If you include these function definitions in your program, do not compile 
with the nocheckabort option. 



222 



223 


Appendix 2 

Error and Warning 
Messages 

223 Introduction 

223 Using Error and Warning Messages 
225 Explanations of Unnumbered Compiler Messages 
227 Explanations of Numbered Compiler Messages 
283 Explanation of C+ + Translator Messages 
320 Explanations of Linker Messages 
327 Enabling Suppressed Messages 


Introduction 

This appendix explains each of the error and warning messages that may 
be produced by the compiler and linker. 

Using Error and Warning Messages 

You should treat warnings as seriously as errors. If you do not know why 
a given warning is being produced, find out why. If you can safely ignore 
the warning in the future, use the ignore option on the compiler or the 
# pragma msg statement in your source code to suppress the warning. 

In general, the compiler attempts to prevent long cascades of error and 
warning messages that result from a single mistake, but this action is not 
always possible. As a result, you may see several messages generated by 
the same error, especially if the error is in a control statement such as an 
if, for, do, or switch statement. If you receive some messages that 
seem to be incorrect or confusing, fix as many errors or warnings as 
possible, and then recompile your program. The confusing messages may 
disappear. 

Sometimes the compiler may generate an error message for code that 
you believe is correct. In many cases, such errors are the result of 
incorrectly using the preprocessor. A typographical error in a 
preprocessor macro or accidental collision of a ((defined macro name 
with another name in your program can cause very confusing problems. 

If you think you are having problems with preprocessor macros, compile 
your program with the pponly option to generate preprocessed output, 
and check that to see exactly what the compiler is receiving. 



Alternatively, compile with the list option to generate a listing file. The 
listing file allows you to see exactly what symbols are being defined by 
the header files included by your program. You can also use the 
find symbol compiler option to locate where a preprocessor macro is 
defined. 

Some error or warning messages are produced at the first non- 
preprocessor statement after the actual condition that caused the error or 
warning. For example, if your program is missing a semicolon, you do 
not get a message at the end of the line that is missing the semicolon; you 
get a message at the beginning of the next line of code. If you cannot find 
an error exactly where the message occurred, look at several previous 
lines in your source code . Remember, the compiler treats # include 
files as if they are part of your source file. For example, a missing close 
curly brace at the end of your last # include file may result in an error 
message at the first line of your C source file. You can compile with the 
pponly option to help diagnose this type of error. 

By default, many warning messages are suppressed but can be enabled 
with the strict, ansi, or warn options. The descriptions of each 
message indicate whether the message is suppressed and, if so, which 
options enable the message. You can enable any suppressed warning with 
the warn or error options. You can disable any warning with the 
ignore option. You cannot use the ignore option to disable error 
messages. See Chapter 8, “Compiling and Linking Your Program,” for 
more information about the strict, ansi, error, warn, and ignore 
options. See also “Enabling Suppressed Messages" later in this appendix 
for a complete list of the suppressed messages and the options you can 
use to enable them. 

Some messages listed as warnings can also be produced as errors in 
some cases. If a message is produced as an error instead of a warning, it 
cannot be ignored (just as errors cannot be ignored). 

You can display help information on a specific message from the 
message browser utility (scmsg) by clicking on the message and pressing 
the Help key or by invoking the AmigaGuide utility on the file 
sc : help/ scmsg .guide. 
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Explanations of Unnumbered Compiler 
Messages 

Freeing Resources 

If you compile your program and your machine runs low on memory, 
the compiler displays this message and frees memory to enable it to 
continue the compilation. You can force the compiler to free memory 
at any time by pressing Control-F in the window to which the 
compiler is sending output. 

Floating point overflow optimizing constants 

The global optimizer was attempting to perform compile-time constant 
calculations, but the calculations caused a floating-point error. Your 
code is causing floating-point numbers to overflow. 

Can't open type file "name" for mode 

The compiler could not open the specified file. The mode is either 
read or write. 

Combined output filename too long 

The filename produced by the compiler, with the path, overflowed the 
compiler’s internal buffer (255 bytes). 

Can't open sc : libs / lib-name . library 

The specified shared library could not be found. Make sure the library 
is available in sc : libs. 

CXWRN: text 

An internal error occurred. With cxwrn errors, the compiler attempts 
to continue the compilation, but may not be able to do so. Please 
contact the Technical Support Division. 

CXERR : num 

An internal error prevented the compiler from continuing. Please 
contact the Technical Support Division. 

Can’t delete old GST: object is in use 

Continuing with no GST file 

You specified the makegst option, but an existing copy of the same 
GST was in use by another program. Check for other compilations or 
applications that are using the GST. You may also be browsing the 
GST with the hypergst utility. 

Can't open GST file: gst-filename 

The specified GST file could not be loaded. Either the file is an invalid 
GST file, or the file does not exist. 

Invalid symbol definition: symbol-name 

You attempted to define the specified symbol on the command line 
with the define compiler option, but the symbol did not adhere to 
the normal rules for C preprocessor symbol syntax. 
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Seek error on object file 

The compiler attempted to perform a seek operation on the output 
object file but encountered an I/O error. 

I/O error code on file "name" 

The compiler received the specified I/O error code from the operating 
system while attempting to read the named file. Refer to The 
AmigaDOS Manual, 3rd Edition (Commodore-Amiga, Inc. 1991) or see 
the header file dos/dos . h for details on the numeric error codes. 
Warning: Debugging information may be incorrect for 
optimized code. 

You are compiling with the debug option, and you are also using the 
global optimizer. The optimizer eliminates variables and moves 
functions inline, so the debugger may not be able to provide accurate 
information. 
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Warning 1 


Error 2 


Error 3 


Error 4 


Error 5 


Error 6 


Explanations of Numbered Compiler 
Messages 

: invalid preprocessor command 

This warning is generated by invalid use of preprocessor commands. 
For example, you could specify an unrecognized command, fail to 
include a space between command elements, or use an illegal 
preprocessor symbol. The command is ignored and compilation 
continues. 

: unexpected end of file 

This error is generated when the compiler expects more data, but it 
encounters the end of an input file. This error may occur in a 
ft include file or in the original source file. A missing ffendif or 
unbalanced curly brace or parentheses in the source file or in one of 
the previously included files may produce this message. In many cases, 
correcting a previous error eliminates this error. 

: file not found " filename " 

The filename specified in a ft include command was not found or 
could not be opened. 

: invalid lexical token 

A character was found in the file that is not a standard character in the 
C character set or is in an inappropriate place. For example, entering a 
pound sign (#) in the middle of non-preprocessor C code or entering 
nonprintable control characters anywhere except in a comment 
produces this error. 

: invalid usage for macro " macro-name " 

Your code invoked a macro incorrectly. Check for unbalanced 
parentheses and other syntax errors. The problem may be in a macro 
used by the macro that you invoked in your program. 

: line buffer overflow 

A line of preprocessed input was longer than the line buffer size. The 
size of the line buffer is controlled by the ppbuf and memsize 
options. If you do not specify ppbuf or memsize, the size of the line 
buffer is 8192 bytes. 
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Warning 7: register parameters require a prototype 
Stack parameters used 

You compiled with parameters=register or parameters=both, 
but did not provide a prototype for a function that you called. Without a 
prototype, the compiler cannot pass parameters in registers so it passes 
parameters on the stack instead. 

Omitting a prototype can cause problems when your program is linked. 
The compiler identifies functions that expect arguments in registers by 
placing an at sign (3) in front of the function name. The 3 replaces the 
underscore that the compiler normally places at the beginning of 
function names. Because you compiled with parameters=register, 
the compiler prepends the @ sign to the function name when the 
function is defined. However, because you did not provide a prototype, 
the compiler assumes the function is called with stack parameters and 
when the function is called, the caller prepends an underscore (_) 
instead of the 3 sign. The 3 version of the function wall not satisfy the 
reference to the _ version, so the linker will issue an error saying that 
the 3 version of the function is undefined. 

Error 8: invalid conversion 

You attempted to cast a type to an incompatible type. This error usually 
occurs when you attempt to convert something into an array, a 
structure, or a function. Check for missing indirection (*) and/or 
address (&) operators. For example, the following program tries to 
assign a whole structure to a pointer. 

void main(void) 

1 

struct F00 

1 

int a, b; 

) f; 

struct F00 *p; 
p = f; /* Error 8 */ 
p = if; /* Correct */ 


1 
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Error 9: undefined identifier "name" 

The specified identifier has not been declared. You may not have 
included the proper header files to declare an extern, or you may 
have misspelled the name of a variable. This message is produced only 
once for each undeclared identifier. Subsequent uses of the identifier do 
not produce a message. Subsequent declarations of the identifier may 
produce messages about redeclaring the variable. Fix the error that is 
causing the first error 9 message and recompile your program before 
trying to fix additional messages involving the same variable. 

Error 10: invalid subscript expression 

An error was detected in an expression used inside square brackets ([]). 
This error may occur if: 

□ the expression is missing 

□ the expression is a preprocessor macro that evaluates to nothing 

□ the result of the expression is void 

□ the result of the expression is a pointer, a structure, or a union. 


Error 1 1 : string not terminated 

The closing double quote (’’) was not provided when defining a string. 

Error 12: invalid structure reference 

The operand preceding the structure member ( . ) or structure pointer 
(->) operator is not a structure or a pointer to a structure, respectively. 
Make sure you are not trying to reference a structure member with the 
structure pointer operator or a structure pointer with the structure 
member operator. In many cases, correcting a previous error eliminates 
this message. 

Error 13: member name missing 

The name of the desired structure or union member did not follow the 
structure member operator (.) or the structure pointer operator (->). 
Check for preprocessor macros that may be defined to the same name 
as the member. 


Error 14: undefined member "name" 


The indicated identifier is not a member of the structure or union to 
which the structure member operator ( . ) or the structure pointer 
operator (->) referred. 
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Error 15: invalid function call 


An identifier or constant is used where a function or function pointer 
identifier is required. This message can occur if you attempt to use a 
variable not declared as a function or function pointer but give the 
variable a parameter list. The compiler sees the parenthesized 
expression and thinks you are calling a function. Check for 
typographical errors such as leaving out an operator in an expression, 
which produces a variable and a parenthesized expression. Such 
typographical errors may also occur in preprocessor macros. For 
example: 


/* The incorrect expression below generates an */ 

/* "invalid function call" error. */ 

int i, j; 

void function(void) 

( 

i « i + (j*2) ; /* Intended expression */ 
i « i ( j*2) ; /* INCORRECT - deleted "+" operator */ 


Error 16: invalid function argument 

A function argument expression following the left parenthesis of a 
function call is invalid. You may see this message if you omit: 

□ an argument expression 

□ a right parenthesis from a function call 

□ a comma separator between two function arguments. 

For example: 

func( . ) ; 
func( ; 
func(1 2); 

Error 17: too many operands 

During expression evaluation, the end of an expression was 
encountered, but more than one operand was still awaiting evaluation. 
This message may occur if an expression contained an incorrectly 
specified operation. 
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Earning 18: non-ANSI use of operator in preprocessor condition 
This message is suppressed by default, but you can enable it with the 
strict, ansi, or warn=18 options. The ANSI C Standard states that 
the sizeof and comma (,) operators should not be used in 
preprocessor conditions. The SAS/C Compiler supports their use in 
preprocessor conditions, but programs that require strict adherence to 
the ANSI C Standard should not use them. 

Error 19: unbalanced parentheses 

The number of opening parentheses in an expression did not equal the 
number of closing parentheses. If the expression appears correct in the 
C source file, check any preprocessor macros to make sure they 
generate balanced parentheses. 

Error 20: invalid constant expression 

An expression that did not evaluate to a constant was encountered in a 
context that required a constant result. The compiler must be able to 
evaluate any constant expression (for example, expressions used to 
initialize static or external data) when the program is compiled. 
The expression in question did not meet this criterion. You may have 
used an illegal operator for a constant expression (such as ++, +«, 
function calls, and so on), or you may have used a variable whose value 
is available only at run time. 

Error 21: illegal use of struct, union, or array type 

An identifier declared as a structure, union, or array was encountered 
in an expression where such types are not permitted. For example, you 
cannot use the ++ postincrement operator with a structure: 


struct F00 


/* Error 21 */ 
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Warning 22: structure used as function argument 

This message is suppressed by default, but you can enable it with the 
warn=22 option. A structure or union was passed as an argument to a 
function. Although passing structures and unions works correctly in the 
SAS/C language and is legal according to the ANSI C Standard, some 
older compilers do not allow you to pass structures or unions. Other 
older compilers pass a pointer to the structure instead of the entire 
structure. Turn on this warning if your code comes from or must be 
ported to such a compiler. 


Error 23: invalid use of conditional operator (?:) 

The conditional expression operator (? : ) was used incorrectly. You may 
have included the question mark (?) but left out the colon (:). Also, 
check for an invalid expression after the operator. 

Error 24: pointer operand required 

An expression required a pointer at a specific place, but a non-pointer 
operand was provided. The compiler may generate this message if an 
expression after the indirection operator (*) was not a pointer or array 
expression or if the expression before the array indexing operators ( [ ] ) 
was not a pointer or array expression. 

Error 25: modifiable lvalue required 

You have attempted to assign a value to an expression that cannot be 
modified. An lvalue is any expression that can appear on the left side of 
an assignment operation. For example, the ANSI C Standard states that 
the result of a cast is not an lvalue; therefore, the following statement is 
invalid: 


(short)x = 2; /* Error 25 */ 

The following examples also generate this error message: 

Udefine ADDONE(x) (x)++ 

ADDONE( 12) ; /* Error 25: Cannot increment a constant */ 

ADDONE(Sg); /* Error 25: Cannot assign to an address */ 

if (func( 10) - j-2 ) ; /♦ Error 25: was intended, not */ 


ix - Sy; 


Error 25: Cannot 


sign to 


addres: 
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You may have defined a variable with the const keyword and then 
tried to modify the value of that variable. The SAS/C Development 
System Library Reference contains many variables defined with the 
const keyword, especially pointers to strings. This keyword is required 
by the ANSI C Standard and indicates that these variables will not be 
modified in the library function to which they are passed. The const 
keyword is present in the parameter list of the prototype that is found 
in the associated header file. This prototype, not the declaration you 
should include in your program, is what is described in the synopsis for 
each function in the SAS/C Development System Library Reference. Use 
the synopsis as a guideline for your declarations, but do not include the 
const keyword. 

Error 26: arithmetic operand required 

An expression required an arithmetic operand, but the provided 
operand was not arithmetic. An operand is arithmetic if it declared as 
char, short, int, long, float, or double or the signed and 
unsigned variants of these types. 

Pointers, structures, unions, and functions are not arithmetic operands. 

Error 27 : arithmetic or pointer operand required 

An expression required an arithmetic or pointer operand, but a 
structure or union was provided. An operand is arithmetic if it declared 
as char, short, int, long, float, or double or the signed and 
unsigned variants of these types. 

A pointer operand can be a pointer to any other data type, or it can be 
the address of a variable or function. 

Error 28: missing operand 

During expression evaluation, the end of an expression was encountered 
but not enough operands were available for evaluation. The compiler 
may generate this message if you specified a binary operator (such as 
the addition, subtraction, multiplication, or division operator) with only 
one operand. Also, check for invalid preprocessor macro expansions. 

For example: 

int i; 

int ary( 10]; 



i = i + ; /* Error 28 */ 

i = ary[i*]4; /* Error 28 (Among others) */ 
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Error 29: operation cannot be performed on a pointer 

An operation was specified that was invalid for pointer operands, such 
as one of the arithmetic operations other than addition or subtraction. 

Warning 30: pointers do not point to same type of object 

In an assignment statement defining a value for a pointer variable, the 
expression on the right side of the assignment (») operator did not 
evaluate to NULL or to a pointer of the same type as the pointer 
variable on the left side of the assignment operator. The warning is also 
produced when a pointer of any type is assigned to an arithmetic object. 

Error 31: integral operand required 

An expression required a given operand to be an integral type, but the 
actual operand was not an integral type. An operand is integral if it is 
declared as char, short, int, or long or the signed and unsigned 
variants of these types. 

For example, the following code generates error 31: 

double d; 

int ary [ 10] ; 

ary[d) = 10; /* Error 31 */ 

Error 32: cannot convert to required type 

The compiler was unable to convert a data item from its base type to 
the type required by the operation. The compiler may generate this 
message if you attempt to cast any data type to a structure, instead of 
casting the type to a pointer to a structure, or if you attempt to cast a 
structure to any other type. This message can also be produced for 
implied conversions, such as passing a structure as a parameter to a 
function expecting some other type. For example, the following code 
generates error 32: 

struct F00 f; 

int j; 


j = (int)f; /* Error 32 */ 
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Warning 33: non-portable operation on structure or union 

Your code has attempted to use an operator on a structure or union 
that is illegal for that type. For example, you may have used the 
equality == operator on two structures. The ANSI C Standard does not 
permit the use of relational operators on structures or unions. 

The SAS/C Compiler generates the equivalent of a raemcmp call for 
this construct, but it may not perform as expected. Because structures 
may contain padding bytes, two structures of the same type with all 
identical members may compare false. If you intend to use direct 
structure comparison, make sure you declare the structure static or 
extern, or initialize the structure to zeroes using a call to memset. 
For example, the following code generates warning 33: 

((include <proto/dos.h> 

struct FilelnfoBlock fibl, fib2; 

if(fib1 == fib2) /* Warning 33 */ 

Error 34: invalid initializer expression 

The expression used to initialize an object was invalid. The compiler 
may generate this message if you fail to separate elements in an 
initializer list with commas or if you attempt to initialize an array to a 
single object, as shown in the following examples: 

int a [ 3 ] = 0; /* Error 34 */ 

int b [ 3 ] = | 1 2 3 ); /* Error 34 */ 

Error 35: closing brace expected 

The compiler expected a closing brace (1) to terminate the definition of 
a function, structure, or nested block scope, but the brace is missing. 
The compiler may generate this message if: 

□ too many elements occur in an initializer expression list 

□ a structure member was improperly declared 

□ the end of the source file is reached before a definition is complete 

□ a previous error occurred in a control statement. 
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Warning 36: control cannot reach this statement 

A statement with no label followed a goto, return, break, or 
continue statement. The statement is therefore unreachable. This 
warning can sometimes be produced incorrectly if the compiler reported 
a previous error while in a control flow statement. Fix all previous 
errors and recompile your program before trying to fix the error that is 
generating this message. 

Error 37: duplicate statement label "name" 

See line number file "filename" 

The specified statement label has already been defined in the current 
function. You cannot define the same label more than once in the same 
function. 


Error 38: unbalanced braces 


Error 39: 


Error 40: 


Error 


In a set of compound statements, the number of opening left braces ({) 
did not equal the number of closing right braces (}). This error may be 
produced incorrectly if the compiler reported a previous error in a 
control flow statement. Fix any previous errors and recompile your 
program before trying to fix the error that is generating this message, 
invalid use of keyword "keyword" 

One of the C language reserved words appeared in an invalid context 

(for example, as a variable name). 

break not inside loop or switch 

A break statement was detected that was not within the scope of a 
while, do, for, or switch statement. This error may be produced 
incorrectly because of errors in previous statements, 
case not inside switch 


A case prefix was encountered outside the scope of a switch 
statement. This error may be produced incorrectly because of errors in 
previous statements. 
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Warning 42: case expression not integral 

The expression defining a case value did not evaluate to an integral 
constant. This message is generated as an error message if the 
expression could not be converted into an integral constant and as a 
warning if the expression could be converted into an integral constant. 
For example, if you use a variable as a case value, the compiler 
generates an error message. If you use a floating-point constant as a 
case value, the compiler converts the constant to an integer 
(thereby truncating its value) and generates a warning message. For 
example, in the following code, the case value 1.6 is truncated to 1, 
and the value —1.6 is truncated to —1. 

switch( i) 

l 

case 1.6: /* Warning 42 */ 

break; 

case -1.6: /* Warning 42 */ 

break; 

1 


Error 43: duplicate of case value 

See line number file "filename" 

You have used the same case value more than once within the same 
switch statement. Check for possible preprocessor macro definitions 
that expand to the same value. For example, both of the following case 
statements evaluate to zero: 

fdefine F00 0 
•define BAR 2 

switch(i) 

I 

case F00: 
break; 

case (F00*BAR) : /» Error 43 */ 

break; 
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Error 44: 


Error 45: 


Error 46: 


Error 47: 


continue not inside loop 

A continue statement was detected that was not within the scope of a 
while, do, or for loop. This error may be produced incorrectly 
because of errors in previous statements, 
default not inside switch 

A default label was encountered outside the scope of a switch 

statement. This message may be produced incorrectly because of errors 

in previous statements. 

duplicate default 

See line number file "filename" 

A default label was encountered within the scope of a switch 
statement in which a default label had already been encountered, 
while missing from do statement 
A while clause did not follow the body of a do statement. This 
message may be produced incorrectly because of errors in previous 
statements. 


Error 48: invalid while expression 

The expression defining the looping condition ina while or do loop 
was void or was missing. If you intend for a loop to be infinite, you 
must supply a constant (such as 1) for the while condition. The error 
may be produced because of a preprocessor macro that expands to 
invalid code. In many cases, fixing a previous error eliminates this 
message. 

Error 49: else not associated with if 

An else keyword was detected that was not in the scope of a 
preceding i f statement. This message may be caused by an error in a 
preceding statement, especially if the previous error occurred while 
processing the if statement with which the else statement is 
associated. 


Error 50: label missing from goto 

The compiler expected a statement label to follow the goto keyword 
but the label was missing. This message may be produced incorrectly 
because of errors in previous statements. 
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Warning 51: C++ comment detected 

This message is suppressed by default, but you can enable it with the 
strict, ansi, or warn=51 options. In C+ + , comments begin with 
two slashes (//) and terminate at the end of the line on which they 
begin. The SAS/C Compiler accepts comments entered in this way for 
convenience and for compatibility with other implementations, but they 
are not part of the ANSI C Standard. 

Error 52: invalid if expression 

The expression following the if keyword on an if statement was 
void, invalid, or missing. This error may be caused by a preprocessor 
macro expanding to inappropriate values or may be the result of an 
expression with an invalid result type (such as a structure type). In 
many cases, fixing a previous error eliminates this message. 

Error 53: invalid return expression 

The expression following the return keyword was void, invalid, or 
missing. The compiler may generate this message if a preprocessor 
macro expands to inappropriate values. In many cases, fixing a previous 
error eliminates this message. 

Warning 54: switch expression not integral 

The expression defining the test value for a switch statement did not 
define an integral value as required by the ANSI C Standard. The value 
supplied is converted to int before any attempt is made to use it. If the 
switch value is a floating-point value, this conversion may truncate 
the value. This warning can also be generated as an error if the value 
could not be converted to int. 

Warning 55: no case values for switch statement 

The statement defining the body ofaswitch statement did not define 
any case statements. This warning may be produced incorrectly 
because of previous errors. 

Error 56: colon expected 

The compiler expected but did not find a colon (:). This message may be 
generated if a case expression was improperly specified or if the colon 
was omitted following a label to a statement. Because the compiler scans 
past newlines, blanks, and comments looking for the colon, this message 
is usually produced at the beginning of the line following the actual 


error. 
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Error 57: semi-colon expected 

The compiler expected but did not find a semi-colon (;). This error can 
be generated if you use too many right parentheses or right curly braces 
(}). Because the compiler scans past spaces and tabs looking for the 
semicolon, this message is usually produced at the beginning of the line 
following the actual error. 

Error 58: missing parenthesis 

A required parenthesis is missing. This error is often caused by 
previous errors. 

Error 59: invalid storage class 

Possible storage classes are denoted by the keywords near, far, 

chip, register, auto, extern, and static. Some of these 

keywords are invalid for certain types of data. For example, you cannot 
declare an external variable with the register keyword, and you 

cannot declare an automatic (local) variable with the chip, 

near, or far keywords. Your code attempted to use a storage 

class keyword incorrectly. This error often occurs because of previous 
errors. 


Error 60: incompatible struct, union or array types 

Incompatible structure, union, or array types were used in an 
expression. 


struct A (int x; | a; 
struct B (double d;) b; 
a = b; /* Error 60 */ 

Error 61: undefined struct/union tag "tag-name" 

Your code has used a structure or union tag that has not been declared. 
Check for misspelled structure names. You may want to compile your 
program with the pponly option or the list option and look at the 
output produced. 

This message is produced as an error if you attempt to refer to the 
members of an undefined structure or union and as a warning if you only 
use pointers to the structure or union. The warning is suppressed by 
default, but you can enable it with the warn=6 1 option. The error 
cannot be suppressed. 
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Warning 62: constant number out of range for type "type" 

Valid range is low to high 

The constant value indicated is not in the range of possible values for 
the type to which the value is being assigned. This message may occur if 
you are assigning a hexadecimal constant with the uppermost bit set to 
a signed variable. By definition, a hexadecimal constant is a positive 
value; therefore, the assignment to the variable reinterprets the constant 
as a negative number. For example, the following lines generate 
warning 62: 

signed char c = 0x80; /* Warning 62 */ 

short s ■> 100000; /* Warning 62 */ 

unsigned short uc = -1; /* Warning 62 */ 

Unless you use the unschar compiler option, variables of type char 
are signed and produce this warning if you assign any constant to them 
with the high bit set (that is, any value between 128 and 255.) You can 
suppress this warning for a specific case by casting the constant to the 
appropriate type. 

Out-of-range constants can cause problems in your code that are hard 
to debug. For example, the following code does not behave as intended: 

int i = Oxff; 

signed char c = Oxff; /* Warning 62 */ 
if (i ” c) 

I 

/* Not executed »/ 

1 


The constant initializer Oxff is the decimal number 255. When 
assigned to the integer variable i, this value is preserved, and i gets 
the value 255. When assigned to the signed character variable c, the 
value of c becomes — 1 because a signed character cannot represent 
numbers higher than 127, and the constant Oxff overflows. Therefore, 
the comparison in the i f statement results in the value false. 

Warning 63: item "name" already declared 

See line number file "filename” 

The named item was previously declared at the cited location. This 
warning is produced when two different members of the same 
structure, union, or enum are given the same name. 
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Error 64: structure contains no members 

A structure declaration did not contain any members. This error can be 
produced by errors encountered during the structure’s declaration. 
Fixing a previous error may eliminate this message. 

Error 65: invalid function definition 

Your code tried to define a function body inside another function body, 
inside a structure declaration, or inside a list of static initializers. This 
message may be produced incorrectly because of errors in previous 
statements. 


Error 66: invalid array limit expression 

The expression defining the size of the subscript in an array declaration 
did not evaluate to a positive integral constant. For example: 


Error 67: illegal object 

Your code attempted to define an illegal item. For example, you may be 
declaring an array of functions (instead of an array of function pointers) 
or a function that returns an array (instead of a function that returns a 
pointer). You may also be attempting to declare something other than a 
function as type void. For example: 

void x; /* Error 67 */ 


Error 68: illegal object for structure 

A structure (or union) included a function as a member. You cannot 
include a function as a member of a structure or union, although you 
can include a function pointer. 

Error 69: struct name includes instance of self 

The named structure or union contains an instance of itself. Although it 
is legal for a structure or union to include a pointer to its own type, the 
structure or union cannot contain an instance of itself. If the structure 
or union does not have a name, the name field is not printed in the 
message. For example, the following code generates error 69: 

struct F00 
1 


int a, b, c; 

struct F00 x; /* Error 69 */ 
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Warning 70: unrecognized escape sequence 

By default, this message is suppressed, but you can enable it with the 
strict, ansi, or warn=7 0 options. Escape sequences in string and 
character constants begin with a backslash (\) and contain one or more 
characters after the backslash. The ANSI C Standard defines some 
escape sequences and reserves others for future expansion and for 
implementation-defined extensions. The SAS/C Compiler ignores the 
backslash on any such undefined escape sequences. Other compilers 
may take different action. For example, the following line prints the 
character q followed by a newline (\n) to stdout: 

printf ("\q\n"); /* Warning 70 */ 

Other ANSI-conforming compilers may substitute any other character for 
the \q escape sequence. 

Error 71: formal declaration error "name" 

A variable was declared before the left curly brace of in an old-style 
function definition, but the variable did not appear in the list of 
identifiers in parentheses following the function name. For example, the 
declaration of j in the following code generates error 71: 


int func(i) 
int i; 

int j; /* Error 71 */ 

I 

1 


You may have misspelled one of your formal parameters or forgotten to 
add the parameter to the parameter list. 
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Error 72: conflict with previous declaration 
See line number file " filename " 

A variable or function was declared that conflicts with a previous 
declaration for the variable or function in the same scope. The message 
indicates the filename and line number of the original declaration. If no 
prototype exists for a function, the first use of that function implicitly 
declares the function as returning an int. If the actual definition of the 
function follows the first use of the function and declares a different 
return type, the compiler produces this message. This message is 
produced as a warning message instead of an error message if the only 
difference between the declarations is that one is a function with the 
const keyword on a parameter and the other does not have the 
const keyword on that parameter. Error 72 may be produced 
incorrectly if you forget to declare a variable in an earlier location and, 
therefore, received a previous error message about an undefined 
identifier with the same name. Fixing the previous error may eliminate 
this message. 

Warning 73: declaration expected 

The compiler expected to find the declaration of a data object or 
function but did not. This message can also occur if you enter too many 
or too few curly braces. This message may be produced incorrectly 
because of errors in previous statements. Fixing the previous errors 
may eliminate this message. 

Warning 74: initializer data truncated 

A static initializer expression contained more elements than the data 
item being initialized, as in the following example: 

char b [ 3 ] = "abed"; /* Warning 74 */ 

String constants always have an implied NULL byte at the end. This byte 
is not counted when producing this warning. If you have a character 
array with three elements, you may initialize it as follows: 


char b [ 3 ] = "abc"; 
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The three elements receive the values a, b, and c. If there is room, the 
NULL terminator byte is also copied: 

char c l 4 1 = "abc"; 

The elements of the above array are assigned the values a, b, c, and \0. 

Error 75: invalid sizeof expression 

The expression passed to the sizeof operator was invalid. This 
message may be produced if an attempt is made to take the size of a 
function, bitfield, or incomplete type, or if the result of the expression 
used is of type void. For example, in the following code, a is an 
incomplete type because its size is not specified when it is declared: 

extern int a [ ] ; 

int i; 

i ■ sizeof (a); /* Error 75 */ 

Error 76: left brace expected 

The compiler expected but did not find an opening left brace. For 
example, you may have omitted the opening brace on a list of initializer 
expressions for an aggregate. 

Error 77: identifier expected 

The compiler expected to find the name of an identifier to be declared. 
The compiler may generate this message if the prefixes to an identifier 
in a declaration (parentheses and asterisks) are incorrectly specified or 
if a sequence of declarations is listed incorrectly, as in the following 
example: 

int ; /* Error 77 */ 


Error 


78: 


undefined statement label "name" 

A goto statement referred to the named label, but the label does not 
exist in the function that referred to it. Check the spelling of your label 
and the goto reference. Make sure the label is in the same function as 
the goto statement. 
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Warning 79: duplicate of enumeration value on line line 

When declaring an enumeration type, more than one enumeration 
constant was assigned the same value, as in the following example: 

enum COLORS 

(RED-1, BLUE-2, GREEN-1); /* RED and GREEN are identical */ 

Any enumeration constants that are not assigned an explicit value are 
assigned values one higher than the previous constant in that 
enumeration. If the constant is the first constant in that enumeration, it is 
assigned the value zero. Therefore, the following enum generates 
warning 79: 

enum COLORS (RED, BLUE, GREEN-1); /* Warning 79 */ 

RED is the first constant, so it is assigned a value of 0. BLUE is assigned 
a value of 1. green is explicitly assigned a value of 1, which conflicts 
with BLUE. 

Warning 80: invalid bit field or misplaced 

This warning is commonly produced if you type a colon (:) when a 
semicolon (;) was expected. This warning can also be produced if you 
are actually declaring a bitfield and give an improper expression for the 
number of bits in the bitfield. 

Error 81: preprocessor symbol loop 
macro expansion too long 

When using the oldpp compiler option, a preprocessor symbol 
expanded to a value that contains a circular reference back to the 
symbol itself, thereby creating an infinite loop in the preprocessor. 

Check the definition of the macro being expanded on the line in 
question. This message cannot occur if the oldpp compiler option is 
not used because the ANSI C Standard prohibits the expansion of 
preprocessor macros that occur as a result of expanding a previous 
instance of the same macro. 
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Error 82: maximum object/storage size exceeded 
Size limit for this class is n 

Your code attempted to declare a data item that exceeded the maximum 
size of objects in its storage class, or the last object declared caused the 
total size of declared objects in that storage class to exceed the maximum, 
as in the following example: 

char near a| 30000] ; 

char near b [ 30000 ] ; 

char — near c [ 30000 ] ; 

Because there is a limit of 65536 bytes on the amount of near data 
allowed, the above request for 90000 bytes of near data will not work. 

If you are compiling with data=near (the default), the near 

keyword is implied on all data items. Fix this warning by declaring 

some large data items with the far keyword or by compiling with 

the data = f ar option. 

Warning 83: reference beyond object size 

Your code used an address beyond the size of the object used as the 
base for the address calculation. This warning usually occurs when you 
refer to an element beyond the end of an array, as follows: 

char c [ 1 0 1 ; 
void myfunc(void) 

( 

c [ 1 1 ] = 0 ; /* Warning 83 */ 

1 

This message can be produced only when the compiler can determine the 
value of the subscript at compile time, that is, the subscript is a constant. 
Warning 84: redefinition of pragma or preprocessor symbol 
"name" 

See line number file "filename" 

Your code is redefining the preprocessor symbol or ((pragma originally 
defined at the indicated file and line number. 
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Warning 85: return value mismatch for function "name" 

Expecting "typel", found "type2" 

The expression specifying the value to be returned from a function was 
not the same type as the function itself. If possible, the value specified is 
converted to the appropriate type. You can suppress this warning by 
casting the return expression to the appropriate type. 

Some pre-ANSI C code produces many of these warnings when 
functions declared as int (either explicitly or implicitly) do not return 
a value. Before the ANSI committee approved the void keyword, 
declaring functions as returning an int was the correct way to handle 
functions that returned nothing. You can compile with the 
nowarnvoidreturn option to suppress these warnings when a 
function that is declared as returning an int actually returns nothing. 

For example, the following two functions generate warning 85: 

function 1 (x) 
int x; 

I 

) /* Warning 85 */ 

int function2(x) 
int x; 

( 

char *p = NULL; 
return(p); /* Warning 85 */ 

1 

You can suppress the warning 85 for functionl by compiling with the 
nowvret option. The nowvret option does not affect function 2 , 
which is attempting to return a pointer from a function declared as 
returning int. 

Warning 86: formal parameters conflict with prototype 
See line number file "filename" 

The types of the parameters to the function do not match the types 
given in the prototype for the function. Check the prototype at the file 
and line indicated against your definition. 
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Warning 87: argument count incorrect, expecting number 
arguments 

See line number file "filename" 

Your code invoked a function with an incorrect number of arguments, 
according to that function’s prototype. Check the prototype at the 
indicated file and line number against your usage of the function and 
the actual function definition. 

Warning 88: argument type incorrect 

Expecting "typel", found "type2" 

Your code invoked a function with an argument whose type conflicts 
with the corresponding parameter as declared in the function’s 
prototype. The type of the argument expected is given as typel, and 
the type of the argument actually provided is type 2. If possible, the 
argument is converted to the appropriate type as if it were cast to that 
type. If the argument cannot be converted, an error message is 
produced. 

Warning 89: constant converted from "typel" to "type2" 

Your code supplied a constant that conflicted with the expected type. 
The constant was converted, but the conversion may have caused a loss 
of precision or lost values. For example, in the following code, the 
prototype for the function f oo specifies an int, but the function is 
passed a double constant: 

void foo(int); 

void myfunc(void) 

( 

foo( 10.67); /* Warning 89 */ 

) 


The double constant is converted to an integer, resulting in an integer 
argument of 10, and the compiler generates warning 89 to inform you of 
the conversion. 

Error 90: invalid argument type specifier 

An error was made in declaring an argument in a function or prototype 
declaration. For example, the following declaration does not specify a 
type for the parameter y. For example: 


void foofint x, y) 
{ 


Error 90 */ 
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Error 91: illegal void operand 

One of the operands in an expression was of type void. The void type 
represents no value and is, therefore, illegal in most expressions. 

Warning 92: statement has no effect 

An expression statement did not produce an assignment, function call, 
or other action. Such a statement serves no useful purpose and can be 
eliminated. This warning is often generated when a typographical error 
has been made in coding the statement. For example, you might enter 
the equality (==) operator when you intended to enter the assignment 
(=) operator: 

int i; 

i ■« 5; /* Warning 92 */ 

In this example, the user intended to assign the value 5 to the integer 
variable i, but because of the extra equals sign, the statement does 
nothing. 

Warning 93: no reference to identifier "name” 

Your code declared an automatic (local) variable but never used the 
variable. However, the variable might be used by code that has been 
excluded from the object module with ((if or flifdef statements. If 
so, you should enclose your declaration of the local variable in the same 
#if or (fifdef statement as the code that references the variable. 

If you want to suppress warning 93, ((pragma msg 93 ignore 
must be in effect when the compiler reaches the line containing the last 
closing brace (}) for the function. If you turn the warning off only for the 
line containing the declaration of the variable, the compiler will still 
generate message 93 when it reaches the last line of the function. The 
line number displayed for the message will be the number of the last line 
in the function. 



Error and Warning Messages 251 


Warning 94: uninitialized auto variable "name" 

An automatic (local) variable was used in an expression before it was 
given a value. Automatic variables are not guaranteed to have any 
specific value when a function is entered, so an uninitialized automatic 
variable can create seemingly random bugs. It is possible for this 
warning to not be produced when appropriate or to be produced 
incorrectly because the compiler does not check all possible execution 
paths. In rare cases, the message is produced incorrectly if the variable 
is used in a loop construct and initialized later in the same loop 
construct, as shown: 

void myfunc(void) 

( 

int i, j; 

for(i»0; i< 1 0 ; i++) 

( 

if ( i > 0) printf ("Xd\n", j); /* Warning 94 */ 
j = i; 

1 

1 

Without doing detailed loop analysis, the compiler cannot tell that j is 
not referenced by the call to printf until after it is initialized. 

Some cases that use uninitialized variables may not produce the 
warning. For example, no warning is produced for the following code 
even though j is not initialized if x is greater than 5: 

void myfunc(int x) 

( 

int j; 

if (x<5) j - x; 

if(j < 5) /* j might be uninitialized */ 

( 

1 

1 
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Warning 95: unrecognized #pragraa operand 

The keyword following a (f pragma statement was not recognized as a 
SAS/C pragma keyword. Version 6 of the SAS/C Compiler supports the 
((pragma libcall, amicall, regcall, flibcall, syscall, 
tagcall, and msg statements. 

Error 96: missing name for ^pragma 

In a libcall, flibcall, syscall, or tagcall #pragma 
statement, the name of the routine to be called was omitted or 
incorrect. 


Error 97: bad library base for ((pragma 

In a libcall, flibcall, or tagcall ((pragma statement, the 
library base was omitted or incorrect. 

Error 98: invalid data for ((pragma 

In a libcall, flibcall, syscall, or tagcall ((pragma 
statement, the offset or magic number fields were invalid. In a # pragma 
msg statement, a syntax error was made specifying the message number 
or the action to be taken. 

Error 99: attempt to change a const value 

Your code attempted to modify a variable declared with the const 
keyword. Variables declared with the const keyword are read-only and 
cannot be modified. 


Warning 100: no prototype declared for function "name" 

Your code called the named function, but the compiler did not find a 
prototype for that function. Without a prototype, the compiler cannot 
perform parameter type checking. Remember, a function that takes no 
parameters still needs a prototype with void as its parameter list: 


int func(void); /* "func" returns "int" and takes no parms */ 


If the function is a SAS/C function, the SAS/C Development System 
Library Reference tells you which header file to ff include to get the 
correct prototype for the function. If the function is an AmigaDOS 
function, its prototype is in the include : cl ib directory in the file for 
its library. For more information, you can refer to the Amiga ROM Kernel 
Reference Manual: Libraries, 3rd Edition (Commodore-Amiga, Inc. 1992) 
or use the grep command to search the header files in the 
include :clib directory for the prototype. 
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Warning 101: redundant keywords in declaration 

The same storage class keyword was specified multiple times when 
declaring a variable, function, or prototype. For example, you may have 
specified the const or chip keyword twice. 

However, you can specify a typedef with a storage class keyword. 
Any variables declared with this typedef are automatically assigned to 
that specified storage class. Therefore, you may get a warning 101 for 
specifying the keyword explicitly on a variable declared with the 
typedef, as in the following example: 

typedef int far farint; 

farint x; /* Declares a far integer called "x" */ 
farint far y; /* Error 101 */ 

Error 102: conflicting keywords in declaration 

You have specified two mutually incompatible storage class keywords 
when declaring a variable, function, or prototype. For example, you 

may have specified the near and far keywords on a variable 

definition. 

However, you can specify a typedef with a storage class keyword. 
Any variables declared with this typedef are automatically assigned to 
that specified storage class. Therefore, you may get an error 102 for 
specifying a 

keyword explicitly on a variable which conflicts with the keyword 
declared with the typedef, as in the following example: 

typedef int far farint; 

farint x; /» Declares a far integer called n x" */ 
farint — near y; /* Error 102 */ 

Warning 103: uninitialized constant "name" 

The named variable was declared const, indicating that the variable is 
read-only, but you have not initialized the variable. If the variable is 
declared static or extern, it is initialized to zero for you but is 
probably not useful unless explicitly initialized. 
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Warning 104: conversion from pointer to const/volatile to 
pointer to non-const/volatile 

A pointer to a const or volatile object is being converted to a 
pointer to a normal object. For example, you may be passing the 
address of a const variable to a function that takes a normal pointer. 
After the pointer has been converted, the const or volatile 
attribute is lost. Therefore, your const data might get modified, or 
your volatile data might be kept in a register. 

In the following example, warning 104 is produced when the function 
foo is called with the const array data as an argument. 

void foo(char *) ; 

void myfunc(void) 

( 

const char data[] = "Hello, World !\n"; 
foo(data); /* Warning 104 */ 
printf ("Xs\n", data); 

1 

void foofchar *p) 

( 

PM1 = 'a'; 

1 

The function foo actually modifies its data by writing to it. Therefore, 
printf prints the value Hallo , World ! instead of Hello , World! 
because the constant array has been modified. 

Warning 105: module does not define any externally-known symbols 
The C source file and all of its included headers were compiled, but no 
externally-visible functions or data items were defined. In this case, a 
valid object file is produced, but it contains nothing that can be 
accessed, and the file can be removed from your link step if you desire. 

Error 106: postfix expression not allowed on a constant 
Your code attempted to apply a postfix ++ or — operator to a 
constant. This message may be generated because of an incorrect macro 
expansion. You can use the pponly option to generate a preprocessed 
file and check the macro expansion. 
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Error 107: too many initializers 

A data item was being initialized, but too many initializer elements were 
provided, as in the following example: 


struct POO 

( 

int i, j; 

1 ; 


struct F00 foo = ( 10, 20, 30); /* Error 107 */ 

Warning 108: zero-length arrays are not an ANSI feature 

This message is suppressed by default, but you can enable it with the 
strict, ansi, or warn=108 options. You have declared an array of 
size zero, probably as a member of a structure to allow variable-sized 
structures. While using zero-length arrays is a common extension to the 
ANSI C Standard and is supported by the SAS/C Compiler, the ANSI C 
Standard does not allow the use of zero-length arrays. 

Error 109: invalid use of type name or keyword 

A type name (possibly a typedef) has been encountered where it was 
not expected. You may have attempted to declare a variable with the 
same name as a keyword. 

Warning 110: enum constant expression is wrong type 
Expecting "type/", found "type2" 

An enumeration constant value was explicitly assigned that did not 
match the type of the enum being declared. For example, specifying a 
double constant when defining an enum or specifying a long constant 
when the shortint option is active will generate this message. 
Example: 

enum COLORS ( RED=1.0 ); /* Warning 110 */ 


Warning 111: non-portable enum type specified 

This message is suppressed by default, but you can enable it with the 
strict, ansi, or warn =1 1 1 options. As an extension to the ANSI C 
Standard, the SAS/C Compiler supports short, char, and long 
enum types with the syntax short enum, char enum, and long 
enum. To improve the portability of your code, enable this warning. 
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Warning 112: include file "filename" not in GST 

This message is suppressed by default, but you can enable it with the 
warn= 112 option. This message lets you know if your code 
ft includes a header file that is not present in the GST. This option 
helps you determine which files should be added to your GST to speed 
up compilation. 

Warning 114: negative shift or shift too big for type 

shifts for type "type" must be between 0 and number 
bits 

Your code attempted to shift an integral value by a constant number of 
bits, but the constant was either negative or higher than the number of 
bits in the value being shifted, as shown in the following examples: 

int i = 1 ; 

i ■ i >> 33; /* Warning 114 */ 
i ■ i « -1; /* Warning 114 ♦/ 

In the first example, i is 32 bits (an int) but is being shifted 33 bits. 
Shifting a value by a number of bits higher than the number of bits in 
the value generates a zero for the result. In the second example, i is 
being shifted by a negative number of bits. Attempting to shift a value 
by a negative number of bits usually generates a zero for the result 
(although this result is undefined by the ANSI C Standard). 

Error 115: enum constant value "number" out of range for enum 
type 

Your code specified a value for an enum constant while defining an 
enumerated type which is out of range for the type of enum being 
declared. Remember that enum constants that are not explicitly assigned 
a numerical value are given the value of the previous constant defined 
in the same enum incremented by one. This increment might place the 
constant’s value out of the acceptable range, as in the following 
example: 


char enum COLORS 


RED=254, 

GREEN, 

BLUE 


Numeric value 
Numeric value 
Numeric value 
Error 115 is j 


is 254 */ 

is 255 (254+1) */ 
is 256 - too big for char 
issued */ 
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The enum constant RED is assigned a value of 254. GREEN does not 
have an explicit value, so it is assigned 254+1, or 255. BLUE does not 
have an explicit value, so its value would normally be 255+1, or 256. 
However, the enum is declared as being a char enum, so 256 is too 
big and error 115 is issued. 

Warning 116: undefined enum tag "name" 

This message is suppressed by default, but you can enable it with the 
warn= 1 1 6 option. A reference was made to an enum that has not yet 
been declared. The compiler may generate this message as a warning if 
only a pointer to the enum is used, but the compiler generates this 
message as an error if any other use is made of the enum. 

Error 117: enum contains no members 

An attempt was made to define an enumerated type, but no member 
names were specified. Use the pponly option to generate a 
preprocessed file if you have problems eliminating this message. 

Error 118: conflicting use of enum/struct/union tag "name" 

An attempt was made to define an enum, struct, or union that has 
the same name as a previously defined enum, struct, or union in 
the same scope. You cannot define an enum with the same name as a 
struct, union, or another enum. 


Error 119: identifiers missing from definition of function 
"name" 


A prototype-style function definition was encountered, but the names of 
the parameters were missing. You can omit the parameter names from a 
prototype, but the names must be present in the actual function 
definition. For example the following code generates error 119: 


void func(int, int, double); /* Legal prototype */ 


void func(int, int, double) 


/* Illegal function definite 
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Warning 120: Integral type mismatch: possible portability 
problem 

Expecting " type f ", found "type2" 

This message is suppressed by default, but you can enable it with the 
strict or warn- 1 20 options. The wrong integral type was passed as 
a parameter. This error may be a problem on another compiler or 
another type of computer if the size of an int is different from the size 
of an int on the Amiga computer. This warning is not a problem if 
your code needs to compile with the SAS/C Compiler only. 

In the following example, the SAS/C Compiler promotes the short 
integer to a long integer even if you compile with the short int 
option: 

f pragma msg 120 warn 
void func(long); 

void main(void) 

1 

short s » 10; 

func(s); /* Warning 120 */ 

1 

However, pre-ANSI compilers on machines that define the int type to 
be the same as short may not perform the conversion or may perform 
the conversion and issue a warning message. In addition, if you remove 
the prototype, this code will not work on any machine where int is the 
same as short. 
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Warning 121: hex/octal constant " constant " too large for char 
High bits may be lost 

Warning 121 is generated if a hexadecimal or octal constant specifies 
more digits than will fit into a single char. 

According to the ANSI C Standard, hexadecimal bytes may be 
specified in a quoted string using the \xhh escape sequence. The ANSI 
C Standard also states that the escape sequence consumes all valid 
hexadecimal characters in the string following the \x, even if all the 
characters consumed will not fit into a single byte, which may not be 
what you want. For example, in the case of \xabcdefgh, you may 
want the character Oxab first, followed by the string cdefgh. 
According to the ANSI C Standard, this escape sequence evaluates to the 
character Oxef followed by the string gh, because the \x consumes all 
valid hexadecimal characters. A single byte cannot hold the hexadecimal 
number Oxabcdef, so the top bits are lost and Oxef is the result. The 
best way to get the character Oxab followed by the string cdefgh is to 
use ANSI string concatenation to terminate the escape sequence: 

"\xab" "cdefgh". The two strings are concatenated to form the 
desired sequence. 


Warning 122: missing ellipsis 

A function or function prototype was encountered that attempted to 
specify variable arguments with a trailing comma in the argument list. 
According to the ANSI C Standard, variable arguments must be 
specified by a trailing comma followed by an ellipsis (...). The SAS/C 
Compiler accepts the form without the ellipsis as if the ellipsis had been 
specified, but other ANSI-conforming compilers may require the ellipsis, 
as in the following example: 


void foo(int x, 
void bar(int x, 


); /* Right */ 

/* Wrong */ 
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Warning 123: no tag defined for enumeration 
Cannot construct prototype 

The genproto option was active, but a prototype could not be 
generated for a function because an enum was used as a parameter to 
the function and that enum had no tag, as shown in the following 
example. 

void myfunc(colors) 

enum (RED, GREEN, BLUE) colors; 

1 

1 

The tag is the name normally appearing immediately after the keyword 
enum in the enum declaration. This message is produced only if the 
genproto compiler option is used to produce prototypes. 

Error 125: invalid number 

The numerical constant specified cannot be represented on the Amiga 
computer. The constant is probably an integer that is too large or too 
small (negative) to be represented in four bytes. This error can also be 
produced if a floating-point number is specified incorrectly or if invalid 
digits are provided to an octal constant. 

The following lines all produce error 125: 

double d « 10.3.2; /* Error 125 ♦/ 

int i = 123456789123456789; /* Error 125 */ 

int j = 099; /* Error 125 */ 

In the first line, the value assigned to the floating-point variable has been 

incorrectly specified. In the second line, the value contains too many 
digits to fit into an int. In the third line, the value begins with a zero, 
which makes the value an octal constant, but it contains the digit 9, 
which is invalid for octal constants. 

Warning 126: (fendif, ((else, or (telif out of order 

A ftendif, #else, or (telif was encountered but no #if or ftifdef 
was active. 
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Error 127: operand to # operator must be a macro argument 

If a preprocessor macro parameter is preceded with the # operator, that 
parameter is replaced with the literal string consisting of the 
corresponding argument to the macro. For example, if you pass the 
argument FOO to a macro, and that argument in the macro definition is 
preceded by the # operator, that argument expands to the string 
"FOO". The # operator can be applied only to macro arguments. 

Error 128: text- f rom-ff error 

This message is the result of a terror preprocessor directive in the 
source code being compiled. The text of the message is taken from the 
((error line. 

Error 129: ambiguous structure or union member "name" 

Your code referred to a structure or union member that did not exist. 

In an attempt to resolve the name, the compiler examined the names of 
all members of substructures or subunions. Two or more members of 
subaggregates matched the name you provided, so the compiler was 
unable to determine which member you intended to specify. 

Suppose you have the following code: 

void main(void) 

I 

struct FOO 

( 

); 

struct BAR 

1 

int a, b, x; 

); 

struct COMBO 

( 

struct FOO foo; 
struct BAR bar; 

) combo; 

combo. a = 10; /* Warning 193 */ 
combo. x = 10; /* Error 129 */ 
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The reference to combo . a succeeds, although it generates a warning 
193 (implicit reference to structure member), because the 
full reference should be combo . bar . a. The reference to combo . x 
generates error 129, because both substructures of combo contain a 
member called x. The compiler cannot tell whether you mean 
combo . f oo . x or combo . bar . x, so it issues the error message 129. 

See Chapter 11, “Using SAS/C Extensions to the C and C+ + 
Languages,” for more information on implicit structure references. 

Error 131: maximum temporary or formal storage exceeded 

The compiler must allocate stack storage to allow you to pass and 
receive structures or other parameters to and from functions. Your 
function used more stack space than one function is allowed to use. 
Parameters are copied onto the stack for each function call, so if you 
are passing large structures, your code will run very slowly. Consider 
passing a pointer to your structure instead of the entire structure. 

Warning 132: extra tokens after valid preprocessor directive 

The ANSI C Standard does not allow extra text on a preprocessor line, 
but this extra text may be allowed by some C compilers. For example, 
many programmers put a descriptive word after a ft end if directive 
indicating the ft if to which the ft end if belongs. To make your code 
ANSI-compatible, you should place such descriptive words in comments, 
as shown in the following example: 

iifdef S0HGTHIN6 

lendif SOMETHING /* Warning 132 */ 

Iifdef SOMETHING 

lendif /* SOMETHING */ /* No warning */ 

Error 133: cannot redefine macro "name" 

An attempt was made to redefine a built-in preprocessor macro, like 
PILE or LINE You cannot redefine built-in preprocessor 
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Warning 134: too many arguments 

A macro definition was encountered with more than the allowable 
number of arguments. The current ANSI limit for macro arguments is 
31, and the SAS/C Compiler does not allow more than 31 arguments. If 
message 134 is issued, the macro is not successfully defined. Any use of 
the macro in your code produces a warning for a function with no 
prototype and possibly a linker error when the name of the macro 
cannot be resolved by the linker. 

Error 135: argument count incorrect for macro "name", 
expecting number arguments 
See line number file "filename" 

Your code invoked a macro with too few or too many arguments. The 
macro is defined at the specified file and line number. 

Error 136: invalid use of register keyword 

Your code used one of the register keywords inappropriately. The 

register keywords are register, aO, dO, al, dl, and so 

on. 

Warning 137: ANSI limits Kline numbers to between 1 and 32767 
This message is suppressed by default, but you can enable it with the 
strict, ansi, or warn=137 options. The ANSI C Standard states 
that line numbers specified with a Kline directive should be between 1 
and 32767. However, the SAS/C Compiler accepts any number that will 
fit into a signed four-byte integer. 

Error 138: operation invalid for pointer to void 

Your code attempted to perform an operation on a void * pointer that 
is not valid for void *. Such operations include addition, subtraction, 
array indexing, and dereferencing (unary * operator). For example, the 
following code attempts to perform addition on a void * pointer: 

void *p = NULL; 


p = p + 1; 


/* Error 138 */ 
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Warning 139: missing tfendif 

See line number file "filename" 

The compiler encountered an ((if, Ififdef, or ft el if statement for 
which there is no matching flendif. The file and line number of the 
unmatched directive is specified in the message. This message occurs 
only at the end of the source file, so large portions of your program 
may have been ignored because of a stray #if or # if ndef with no 
matching #endif. 

Warning 140: sizeof operator used on array that has been 
converted to pointer 

Use of the sizeof operator on an array name gives the size of the 
array. However, if the array name has been converted (cast) to a 
pointer, the resulting size is the size of the pointer (4 bytes), not the 
size of the array. Almost any use of an array name in an expression 
implicitly casts the array name to pointer. To determine the actual size 
of the array, pass only the array name to the sizeof operator. 

In the following example, in the first assignment statement, i gets the 
value 4 (the size of a pointer to a character). In the second assignment 
statement, i gets the value 10. 

char ary[ 10] ; 
int i; 

i = sizeof (ary+1); /* Warning 140 */ 

i = sizeof(ary); 

Error 142: array size never given for "name" 

You can declare an array as extern and not specify the first subscript. 
However, when you define the array, you must specify the subscript. 
Storage is allocated when you define an array, not when you declare an 
array as extern. For example: 

extern char ary 1 [ 1 [ 1 0 ] ; /» Legal */ 

char ary2[ ] ( 10| ; /* Error 142 */ 

Error 143: object has no address 

An attempt was made to take the address of something that has no 
address. You may be attempting to take the address of a register 
variable or an expression. 
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Warning 146: case value out of range for switch type 

A case value was specified in a switch statement that can never be 
taken. For example, if you compile with the shortint option and a 
switch statement is switching on a short or int value, case values 
too big to be stored in 16 bits will generate this warning: 

/* The SHORTINT compiler option is on. */ 
int i = 10; 

switch( i) /* i is a 16-bit integer */ 

{ 


case 0x08000000: 
break; 

/* Warning 146 

case 65000: 
break; 

/* Warning 146 


) 

Warning 147: conversion between function and data pointers 

Your code has cast or otherwise converted a pointer that points to a 
function to a pointer that points to data. The ANSI C Standard states 
that this conversion is not legal. This conversion works with the SAS/C 
Compiler in most circumstances, but you should use the 
absf uncpointer compiler option if your code is larger than 32K. 

Warning 148: use of incomplete struct/union/enum tag "name" 

See line number file filename 

This message is suppressed by default, but you can enable it with the 
warn = 1 48 option. An incomplete tag is one for which no definition has 
been seen. The ANSI C Standard allows use of an incomplete tag (for 
declaring pointers, for example). If you want to know when an 
incomplete tag is being used, enable this warning. You may also want to 
enable warning 149. 
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Warning 149: tag " tag-name " was incomplete in prototype 
See line n file "filename" 

This message is suppressed by default, but you can enable it with the 
war n = 1 49 option. An incomplete tag was discovered in a prototype 
and the function is defined in the same module. An incomplete tag is 
one for which no definition has been seen. The ANSI C Standard 
requires the incomplete tag’s scope to end at the end of the prototype. 
Therefore, any definition of the function later, even if the tag in 
question has been defined, may generate an error message and 
terminate the compilation. You may want to turn on warning 148 to get 
more information about incomplete tags. If you do not want to see all 
the incomplete tag information, you can identify most problems by 
enabling only warning 149. 

In Version 6.0, this warning was produced any time a prototype 
contained an incomplete tag, regardless of whether the function was 
defined later in the same module. 

The following function definition produces an error on many ANSI- 
conforming compilers because the structure FOO referred to in the 
definition is considered to be a different structure FOO than the one 
referred to in the prototype. 


void func(struct FOO *); 

struct FOO 

( 

int x, y, z; 

1 ; 

/* Many compilers issue an error here. */ 
void func( struct FOO *foo) 

1 

1 


This error could be fixed by moving the definition for the structure FOO 
before the prototype. 
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Warning 150: the keyword "name" is meaningless for itemtype 

When declaring a function or data item, you have used a keyword that 
is meaningless for that type of item. For example, you cannot specify 
the following: 


void chip foo(int); /* Warning 150 */ 


It is meaningless to say that a function is to be allocated in chip 

memory. 

The near and far storage class keywords are valid on both 

functions and data items, but have slightly different meanings. See the 
descriptions of the data=near and code=near options in Chapter 8, 
“Compiling and Linking Your Program,” for more information. 

Some keywords that are valid on functions are also valid on data 
items because the data items may be pointers to functions of the 
designated type. For example, you may have a function that returns a 

pointer to a regargs function. Keywords in this category include 

stdargs, regargs, asm, and interrupt. 

Other keywords need to be present only on the function definition. 
You do not need to add them to function pointers and function 

prototypes. Keywords in this category include stackext and 

saveds. If these keywords appear on a data item, warning 150 is 

generated and the extra keyword is ignored. 

For more information on specifying keywords, see Chapter 11, “Using 
SAS/C Extensions to the C and C+ + Languages." 

Error 152: cannot define function via typedef name 

Your code attempted to define a function using a typedef, as shown 
below: 


typedef int foo(int); 
foo bar /* Error 152 */ 

I 

1 


According to the ANSI C Standard, you cannot define a function using a 
typedef. The SAS/C Compiler does not accept such a definition. 



268 Appendix 2 


Warning 154: no prototype declared for function pointer 

Function pointers require prototypes just like functions. To declare a 
prototype for a function pointer, enter the parameter list instead of the 
empty parentheses in the definition, as shown in the following example: 

void (*func1)(); /* Warning 154 */ 

void (*func2)(int, double, long); /* No warning */ 

Remember that a pointer to a function that takes no parameters still 
requires a prototype: 

void (*func3)(void) ; /* Function pointer takes no parms */ 

Warning 155: no statement after label 

The C language does not allow a label immediately before the curly 
brace ending a block (}). If you enter a label in this position, the SAS/C 
Compiler generates this warning. Enter a semicolon (representing a 
NULL statement) after the label to suppress the warning, as shown in 
the following example: 

void fund (void) 

( 

goto foobar; 

/* more code */ 
foobar: /* Warning 155 */ 

1 

void func2(void) 

( 

goto foobar; 

/* more code */ 
foobar: ; /* No warning */ 

1 

Warning 156: operation with/comparison of types "type-1" and 
"type-2” 

Your code attempted to use pointers to two different types in an 
operation or comparison. Examine your code carefully; if it seems 
correct, cast one of the pointers to the other pointer’s type. 
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Error 158: invalid type name 

The compiler expected a type name for a cast or offsetof operation, 
but the provided name was not recognized as a valid type name. Check 
the preprocessed output to make sure you are providing the correct 
information. 


Warning 159: use of unary minus on unsigned value 

This message is suppressed by default, but you can enable it with the 
strict or warn= 159 options. Your code has used the unary minus 
operator (— ) on an unsigned variable. Using this operator on an 
unsigned variable may not produce the expected result because the 
result is still a non-negative number. 

Warning 161: no prototype declared at definition for function 
"name" 


An old-style function definition was encountered, and no prototype was 
in scope. The prototype must appear in the C file or a header file before 
the definition of the function, or the function definition itself must be a 
prototype-style definition. 

Warning 162: non-ANSI use of ellipsis punctuator 

This message is suppressed by default, but you can enable it with the 
strict, ansi, or warn=162 options. You have declared a function 
with the ellipsis punctuator (...) but the function has no arguments. The 
ANSI C Standard requires functions that take a variable number of 
arguments to take at least one fixed argument. 

Warning 163: initialization of auto struct, union, or array 

This message is suppressed by default, but you can enable it with the 
strict or warn= 163 options. Your code has initialized an automatic 
structure, union, or array. The ANSI C Standard allows you to initialize 
automatic structures, union, and arrays, but many pre-ANSI compilers 
do not. 
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Warning 164: 6 applied to array 

This message is suppressed by default, but you can enable it with the 
strict or warn= 164 options. Your code has used the address (&) 
operator on an array name. You should instead take the address of the 
first element in the array, or use the array name without the address 
operator. For example: 


int i 

aryl 101 ; 


int ! 

*iptr; 


iptr 

= Sary; 

/* warning 165 

iptr 

= ary; 

/» OK 

iptr 

- tary[0); 

/* OK 


Warning 165: use of narrow type in prototype 

This message is suppressed by default, but you can enable it with the 
warn«165 option. This warning is provided for detecting situations 
that may cause problems on other compilers if your code mixes function 
prototypes and old-style function definitions. See Chapter 13, “Writing 
Portable Code," for information on using narrow types in function 
declarations. See also the descriptions of messages 176 and 179. 

Error 166: unrecoverable error or too many errors 
Terminating compilation 

Your program has exceeded the default or specified maxerr or 
maxwarn values, or an error has occurred that prevents the compiler 
from producing meaningful results. 

The default maximum number of errors is 50. By default, any 
number of warnings may be generated. 

Warning 169: incompatible operands of conditional operator (?:) 
"typel" conflicts with " type2 " 

The operands of the ? : conditional operator must be of compatible 
types. Your code supplied types to the ? : operator that were not 
compatible. For example, the following code generates warning 169: 


int func(void) 

I 

int i - 0; 

Struct F00 *foo = NULL; 

return ( int ) ( i > 0 ? foo : i); /* Warning 169 */ 
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The expression following the question mark (?) is of type 

struct FOO *. The expression following the colon (:) is of type int. 

This message can be an error if it is not possible to convert the types 
in question. This can occur if one of the types is a structure or union. 

Warning 170: overflow during operation on constants 

A constant expression overflowed the limits of the type in which it was 
being calculated. Perhaps you have added or multiplied two large 
integers, thereby resulting in a number too large to represent in a four- 
byte integer. 

Warning 176: implicitly promoted formal "name" conflicts with 
prototype 

See line number file "filename" 

This message is suppressed by default, but you can enable it with the 
strict, ansi, or warn=176 options. You are defining a function 
using an old-style definition, which means that any narrow types (char, 
short, and float) in your definition are implicitly widened to their 
non-narrow equivalents (int, int, and double, respectively). 
However, a prototype is in scope that gives the narrow version of the 
type. 

Functions that call your function will not know that your function is 
using an old-style definition and, with some compilers, may pass an 
incorrect value. An incorrect value is never passed using the SAS/C 
Compiler on the Amiga hardware. See Chapter 13, “Writing Portable 
Code,” for information on using narrow types in function declarations. 
See also the descriptions of messages 165 and 179. 

Warning 178: indirect call without indirection operator 

This message is suppressed by default, but you can enable it with the 
strict or warn» 1 7 8 options. You called a function using a function 
pointer, but did not use the indirection (*) operator to dereference the 
pointer first. The SAS/C Compiler generated correct code, but on 
pre-ANSI compilers this code may not work. Example: 

void (*funcptr) (int) ; 


funcptr(IO); /* Warning 178 */ 
(*funcptr) ( 10) ; /* No warning */ 
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warning 1 


Warning 18 


Warning 18 


Warning 18 


Warning 18 


Warning 18 


9: narrow type used in old-style definition 

This message is suppressed by default, but you can enable it with the 
strict or warn- 179 options. Your code has used a narrow type 
(char, short, or float) in an old-style definition. See Chapter 13, 
“Writing Portable Code," for information on using narrow types in 
function declarations. See also the descriptions of messages 165 and 
176. 

0: no space between macro name and its replacement 
list 

This message is suppressed by default, but you can enable it with the 
strict, ansi, or warn - 180 options. Your code is defining a 
preprocessor macro that takes arguments but does not have at least one 
blank after the closing parentheses of the argument list. The ANSI C 
Standard requires white space after the closing parentheses. For 
example: 

(pragma msg 180 warn 

Idefine ADD(a,b) (a+b) /* Warning 180 */ 

1 : "name" was declared both static and external 
See line number file "filename" 

Your code has declared a function or a global variable as both static 
and external at different places. Both the function and its prototype 
must agree on whether the function is static. 

2: static function "name" declared but not defined 
See line number file "filename" 

Your code had a prototype for a function declared static but never 
defined the function. The function definition may be hidden with # i f or 
# if def statements. 

3: inline function "function" declared but not defined 
See line number file "filename" 

Your code had a prototype for a function declared inline but 

never defined the function. The function definition may be hidden with 
(if or K i f def statements. 

4: unterminated character constant 

Your code has specified a multibyte character constant (such as ' ab ' ), 
and you did not compile your code with the mbchar option; or, if you 
compiled your code with the mbchar option, the multibyte character is 
larger than the permitted four bytes. 
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Error 185: 


Warning 186: 


Warning 187: 


Warning 190: 


comma expected 

The compiler expected a comma but did not find one. This error may be 
produced because of errors in previous statements. Fix all previous 
errors before fixing this one. 

implicit conversion between pointer and scalar 
Your code has converted a pointer to an integer while doing static 
initialization. You can suppress this warning by casting the pointer to 
the appropriate type. 

negative value assigned to unsigned type 
This message is suppressed by default, but you can enable it with the 
strict or warn= 187 options. Your code has assigned a negative 
constant to an unsigned variable. In doing so, your code is in effect 
assigning a very large positive number to the variable, which may or 
may not be the action you intended. 

{{include ignored because header already included 
See line number file " filename " 


This message is suppressed by default, but you can enable it with the 
warn=190 option. The nomultipleincludes compiler option is 
active, and your code included the same header file more than once. 
The compiler ignores the additional {(include statement. You can use 
this message to locate all such multiple includes if you want to modify 
your header files to not include the same file more than once. 

You can get even more information about which header files were 
included by using the listincludes compiler option. 


Error 192: wrong size for enum 

An enum variable was declared to be of a different type than the base 
enum was when it was defined. Suppose you have the following code: 


char enum COLORS = (RED, GREEN, BLUE); 
enum COLORS color; /♦ Warning 192 */ 
char enum COLORS color2; /* correct */ 

The enum variable color should be declared the same size as the base 
enum type, which is char enum. The base enum type overrides the 
enum variable’s type definition. 
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Warning 193: implicit reference to struct/union member 
Reference assumed to be "reference" 

Your code has referred to a struct or union member name that is 
actually a member of a substructure or subunion of the original. The 
compiler has searched all substructures and subunions and determined 
that exactly one member matches the name you specified, so it is using 
that member. The reference printed in the message text is the fully 
expanded name of the member that it is using. If you intend to take 
advantage of this feature of the SAS/C Compiler, you may disable this 
warning with the ignore- 193 option. If you choose to disable this 
warning, your code may not work on other compilers. 

For more information on using implicit structure references, see 
Chapter 11, “Using SAS/C Extensions to the C and C+ + Languages.” 
Warning 194: too much local data for NEAR reference, 
some changed to FAR 

You have declared more than 32K of static data. The compiler can 
address up to this amount using 16-bit offsets. Amounts greater than 
32K must be addressed using 32-bit offsets. You may have compiled 
with the data -far only option and declared some data with the 

near keyword. If your entire project is in one source file or is 

compiled with data = f aronly, you can ignore this warning unless you 
get an error later in the compilation or link. Otherwise, you must 
eliminate some near data in one of three ways: 

□ Compile your program with the strmerge compiler option. This 
option moves all string constants to the code section, thereby moving 
them out of the near data section. 

□ Declare read-only data as static const. When you compile with 
the stringmerge option, this data will also be moved to the code 
section. 

□ Add the far keyword to some of your larger external or static data 

items to move those items from the near section to the far section. 

□ Specify thedata-far compiler option to move all data items except 

those declared with the near keyword to the far section. 

Note: The second line of message 194 is not printed unless you 
compiled with the data-auto option, or you compiled with the 
data = f aronly option and declared data with the near keyword. 



Error and Warning Messages 275 


Warning 195: nested comment detected 

This message is suppressed by default, but you can enable it with the 
warn= 195 option. The compiler found the start of a comment (/*) 
inside of a comment. Some compilers allow comment nesting and others 
ignore the start of the second comment. The ANSI C Standard does not 
allow nested comments. If you choose to use nested comments, you 
should specify the comnest compiler option. However, using the 
comnest option prevents your code from running on most ANSI- 
compliant compilers. 

Warning 196: specified include directory not found: "name" 

The named directory does not exist or could not be accessed. 

Warning 198: regargs and asm cannot be used on a varargs 

function 

Functions that take variable numbers of parameters always pass their 

parameters on the stack. The regargs and asm keywords are 

invalid for these functions. 


Error 199: unbalanced comment 

See line number file filename 

Your code has a comment open (/*) with no corresponding comment 
close (*/). This condition is not detected until the end of the C source 
file. 


Warning 200: No register specified for parameter to asm 

function 

You have declared a function with the asm keyword, but you did not 

select a register for one or more of the parameters. For example: 


int asm foofint x); /* WRONG! No register for ' x ' ! */ 

int asm bar(register dO int x); /* RIGHT! */ 
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Warning 202: relational comparison between unsigned and zero 

Your code compared an unsigned value with zero in such a way that the 
expression will always be true or always be false. For example: 

unsigned int x; 

if (x < 0) /* Never true! */ 


if(sizeof(x) >= 0) /* Always true! */ 


This message is suppressed by default, but you can enable it with the 
strict or warn=202 option. 

Warning 204: invocation of macro "macro-name" too large or not 
terminated 

Your code invoked a macro but did not supply enough closing 
parentheses to terminate the invocation. Also, check any of the macros 
that are invoked by the macro that you invoked directly in your code. 
Warning 209: macro name invocation may have multiple side 
effects 

You have passed an expression with a side effect as an argument to a 
macro, and that macro has evaluated the argument more than once. 
Operators with side effects are ++, — , +=, /=, *«, -m, >>=, <<=, | =, 
S=, and =. 

For example, the max and min macros evaluate each argument twice. 
If you invoke the max macro as MAX( i++, j ), the first argument is 
evaluated twice, and two post-increments take place. A typical definition 
of the max macro as follows: 

Sdefine MAX(x,y) ( ( x ) > (y) ? x : y) 

int i = 0 ; 

i = HAX( i++, 0); /* Warning 209 */ 

The macro expands to: 

i = ( (i++) > (0) ? i++ : 0); 

The expansion contains the expression i++ twice, so if that branch of 
the ? : operator is executed, the variable i is incremented twice. 
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Warning 21 


Warning 21 


Warning 21 


Warning 21 


This warning may sometimes be produced incorrectly, but you should 
examine each case to determine whether there is an error. 

Function calls are also considered side effects, but function calls 
produce warning 217 instead of warning 209. 

2: item "name" already declared 
See line number file "filename" 

This message is suppressed by default, but you can enable it with the 
warn= 2 1 2 option. You have declared an item twice. For example, you 
may have specified the prototype for a function twice, or you may have 
declared an extern twice. The declarations do not conflict, or the 
compiler would generate error 72, but code is harder to maintain if it 
defines the same item in more than one place. You may want to use the 
nomultiple includes option to suppress multiple ((includes of 
the same file if you enable warning 212. 

3: empty argument to preprocessor macro "macro-name" 

This message is suppressed by default, but you can enable it with the 
strict, ansi, or warn=2 1 3 options. Your code calls a preprocessor 
macro with no argument text. This action is accepted by the SAS/C 
Compiler but is not permitted by the ANSI Standard. For example: 

fdefine FOO(a.b) a 
F00( 10,) 

6: symbol "name" found 

You have compiled with the f sym compiler option, and the compiler 
has found a definition of one of the symbols that you specified as the 
parameter to the f sym option. 

7: macro invocation may call function multiple times 
You have passed a function call as an argument to a macro that 
evaluates its arguments more than once. This action may cause 
incorrect results. See also the description of message 209. 
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Error 


218 : 


declaration found in statement block 
The compiler found a declaration where it expected a statement. You 
may have a statement in the middle of your declaration block, or vice- 
versa. Any declarations found after this error are added as external 
variables, which suppresses warnings about undefined variables but 
may create additional errors later if your code declares a variable of the 
same name. In the following example, the variable y is declared after 
the first statement of the function: 


void func(void) 

( 

int x; 
x = 10; 

int y; /* Error 218 */ 


Warning 220: old-fashioned assignment operator 
taken as "operators" 

This message is suppressed by default, but you can enable it with the 
strict or warn=220 options. Older compilers allowed the operators 
=-, =+, and so on. In ANSI C, these operators are specified as -=, +=, 
and so on. The older specification is ambiguous when assigning certain 
expressions (for example, x=-5 ; and x= -5 ;). To resolve this 
ambiguity, newer compilers use -=, and some pre-ANSI compilers use 
=-. Therefore, you should enter at least one space between the equals 
(=) sign and whatever operator follows it to ensure portability. 

Error 223: "filename" is not a valid GST file 

The specified filename was supplied using the gst compiler option as a 
Global Symbol Table file, but it is not a valid GST file. Delete the bad 
file and try re-creating it. 
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Warning 22*1: item "name" already defined 

See line number file "filename" 

This message indicates that a variable, function, or typedef is being 
defined for the second time in a given scope. This message is normally 
an error, but if the redefinition is harmless, the compiler allows it and 
issues the message as a warning instead. As shown in the following 
example, the compiler allows redefinition of typedef names in the 
same scope if the new type is identical to the old type. The compiler 
does not allow redefinition of functions or variables in the same scope. 


typedef int foo; 

typedef int foo; /* Warning 221 */ 

void func(void) 

( 

1 

void func(void) /* Error 224 */ 

[ 

) 

Warning 225: pointer type mismatch 

"typel" does not match "type2" 

Your code has performed an assignment or some other operation on 
two incompatible different pointer types or on a pointer type and an 
arithmetic type. For example: 

struct POO 

I 

int x, y, z; 

1 foo; 
int *ip; 


ip = ifoo; /* Warning 225 */ 



280 Appendix 2 


Error 226: cannot convert "type 1" to " type2 " 

The compiler was unable to perform a requested or implicit conversion. 
For example, if one of the types is an instance of a structure, the 
structure cannot be cast to another structure type or to an arithmetic 
type. For example: 


struct POO 

1 

int x, y, z; 

) fo°; 
int i; 

i = (int) foo; /* Error 226 */ 


Warning 301: Indirect reference through NULL pointer. 

The program being optimized contained code to dereference a pointer 
with a NULL value. The results of such a dereference are undefined but 
may include an addressing exception or a system crash. 

Warning 302: Type punning involves representation change symbol 
A variable defined with one type was used with a different type. This 
practice is known as type punning. This message can occur, for example, 
when an assignment is made to a member of a union and then the value 
is accessed from a different member of the union. 


Warning 303: Reference has overlapped definition symbol 

The indicated identifier has at least two definitions that partially overlap 
its storage. 

Warning 304: Dead assignment eliminated symbol 

symbol was assigned a value on the indicated line, but the value was 
never used. The assignment was eliminated. 

Warning 305: Uninitialized variable symbol 

The named identifier was not initialized before it was used. The 
identifier's value is unpredictable. 
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NOTE 306: reason function inlined: function namef from 
line n ) 

The named function was expanded inline at the line associated with the 

message. The reason is inline, complexity = c, or local, 

depending on which inline option caused the inlining to occur, c is the 
complexity of the function (not the value of the complexity option). The 
section (from line n) is only included when the location at which 
the call was expanded differed from the location of the call. This 
message happens when levels of inlining are occurring. The value n is 
the line number of the call. 

Error 402: Wrong number of parms to builtin function 

The wrong number of parameters were passed to a builtin function. The 
builtin function will not be used. 


Error 403: 
Error 404: 

Error 405: 

Error 406: 

Error 407: 
Error 408: 

Error 409: 


Argument(s) to function-name must be int type 
The builtin function requires an integer parameter. 

builtin_fpc requires MATH=68881 option 

The builtin_fpc function was used without the math=6888 1 

option. 

Floating point opcode must be a constant. 

The parameter to builtin_fpc must be a constant, since it is the 

opcode for a 68881 instruction. 

Offset from library base must be a constant 
A # pragma libcall statement was declared with a variable for the 
offset for the jump vector. 

Offset from library base must be negative 
Jump vectors are always negative from the library base. 
Insufficient parameters for library call 
The number of parameters to a #pragma libcall does not match 
the magic number in the # pragma statement. 

Too many parameters for library call 

The number of parameters to a flpragma libcall does not match 

the magic number in the # pragma statement. 
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Error 410: Invalid register specification for getreg/putreg 

The register number is out of range. Refer to the header file dos . h for 
a list of registers. 


Error 411: Value for getreg/putreg must be an integral type 
The register must be a constant. 

Error 412: FP register used without co-processor 

You must specify the raath=6888 1 option to use floating-point registers 
in ((pragma flibcall statements. 

Error 415: Same register used twice for parameters 

The same register was specified for more than one parameter in an 
asm function. 


Error 416: No register specified for ASM call 

A parameter was specified without a register in an asm function. 

Error 417: No Data register available to reach far formals. 

Reduce the size of auto variables or reduce the 
number of register parameters. 

If you have more than 32K of auto variables and formal parameters, 
the compiler needs an extra register to reach the formal parameters. If 
all registers are used as parameters, you will get this message. 
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Explanation of C+ + Translator Messages 

Error 1101: Illegal token. 

A symbol that is not recognized as a valid token has been detected in 
the input. For example, you may have a symbol that you intended to be 
a C + + identifier, but it contains a character not permitted in 
identifiers. For instance, symbols cannot have a number as the first 
character of the identifier. 

Error 1102: Can't find file: filename. 

The file specified in a # include directive cannot be found. 

Error 1103: Invalid file name. 


The filename in a #include directive must be enclosed in double quotes 
(“”) or angle brackets (<>). See “F.3.13 Preprocessing Directives" in 
Appendix 3, “Implementation Defined Behavior,” for information on 
when to use quotes or brackets. 

Error 1104: End of file encountered in comment. 


The end of the source file has been detected while a comment was being 
processed (and before the comment terminator was seen). 

Warning 1105: Invalid escape sequence. 

An invalid escape sequence has been detected. An invalid escape 
sequence is a backslash (\) followed by a character not valid in such a 
context. For example, \z is not a valid escape sequence. 

Error 1106: illegal preprocessor directive. 

A # character followed by a symbol not recognized as a valid 
preprocessor directive has been detected. You may have misspelled the 
directive. 


Warning 1107: Extra token(s) after preprocessor directive. 

A #if, #else, or Send if directive has been followed by some text 
not within a comment. 


Error 1108: Missing identifier in preprocessor context. 

An identifier is required in the given preprocessor context but is not 
present. For example, if your program says Sif defined instead of 
Sif defined myfunc, this message is issued. 

Warning 1109: Redefinition of preprocessor symbol: symbol. 

A previously defined symbol has been redefined. This message is 
produced as a warning if the new definition is the same as the old 
definition, but it is produced as an error if the two definitions are 
different. 
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Error 1110: Missing ')' in macro call. 

A prior occurrence of a left parenthesis has been detected in a macro 
call but has not been matched by a right parenthesis. 


Error 1111: Missing argument to preprocessor macro. 

A preprocessor macro has been called with fewer arguments than the 
macro requires. Check the definition of the macro to determine which 
arguments are missing. 

Error 1112: Missing comma in preprocessor expression. 

A comma is required to separate the arguments in the definition or call 
of a function-like preprocessor macro. 

Error 1113: Illegal operator in preprocessor context. 

The preprocessor has detected an operator that it cannot understand. 
Examples of operators that are illegal in the preprocessor context are: 
++, — , and ->. 


Error 1114: Missing operand in preprocessor context. 

An operand was expected but not found. 

Error 1115: Illegal expression in preprocessor context. 

The preprocessor has encountered an expression that it cannot 
understand. For example, an operand may be expected but is not 
present, or the operand is of a non-integral type (for example, a 
floating-point constant). 

Error 1116: Preprocessor number not a true number. 

A token beginning with a digit resembles an integer or floating-point 
constant, but is not correct. For example, you may have mistyped a 
digit in a hexadecimal constant or mistyped a floating-point exponent 
field. 


Error 1117: Integer required in preprocessor expression. 

A non-integer operand has been detected in a preprocessor expression. 
The logical operators (!, 1 1 , and &&) require integral operands. 
Error 1118: Extra flelse or #elif. 

A (else or ftelif directive has been found without a matching #if 
directive. 

Error 1119: Extra ftendif. 

A # end if directive has been found without a matching #if directive. 
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Error 1121: Invalid (fline format. 

The preprocessor has encountered an invalid #line directive. The 
form of the ((line directive is 


Jline number " string " 


number must be an integer constant and string must be enclosed in 
double quotes. 

Error 1122: Missing parenthesis in preprocessor expression. 

A beginning left parenthesis has been detected in an expression but was 
not matched by a right parenthesis. 

Error 1123: Illegal use of H operator. 

The identifier following the # operator is not an argument to the macro 
being defined. 

Error 1124: terror directive. 


Error 1125: 


Error 1126: 


Error 1127: 


Error 1129: 


Error 1130: 


The preprocessor has encountered a terror directive. This message is 
issued whenever a terror directive is encountered. 

Illegal tt expression. 

Either the first or second operand of the 1 1 operator is missing. This 
may happen if the 1 1 expression begins or ends the line. 

Illegal operand of tt operator. 

An operand of the 1 1 expression is not an identifier. You may have 
misspelled the identifier. 

Unterminated string or character constant. 

A string (starting with a double quote) or a character constant (starting 
with a single quote) was begun but not terminated. 

Character literals must contain at least one 
character . 

Two consecutive single quotes were found with no intervening 
characters. Character literals must have at least one character between 
the single quotes. 

Unterminated preprocessor conditional. 

The end of the source file was reached while a conditional preprocessor 
directive (such as the Selif directive) was pending. One or more 
# end if directives are missing. 
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Error 1200: 


Error 1205: 


Error 1206: 


Warning 1207: 


Warning 1208: 


Error 1319: 


Error 1320: 


Error 1321: 


Error 1322: 


Syntax error more-explanation. 

A syntax error has been detected. There are many forms of message 
number 1200. The amount of information provided in these messages is 
dependent upon the context in which the error occurs. 

Newline within string or character literal. 

The newline character (indicating an end of line) has been found within 
a string literal or character literal. Usually this occurs when a 
terminating single quote or double quote has been omitted from the 
literal. To cause a newline character to appear in the output, use the \n 
escape sequence, as in "Hi\n". 

Bad character in input {hex-number) . 

The specified character has been detected in the input and is not an 
acceptable character for a token. Normally this condition occurs only if 
your source file has had odd characters inserted in it, perhaps as a 
result of uploading or downloading the file from one machine to 
another. 

Asterisk found as first character of C++ style 
comment . 

You may have made an error in starting the comment. Perhaps you 
meant to begin a C comment (/* */) instead of a C+ + (//) comment. 
C style comment starting on line line-number never 
ends . 

There is no terminating * / sequence to the comment. Either you have 
forgotten the comment terminator or you intended the comment to be a 
C+ + comment. 

'identifier' not declared. 

The specified identifier is not declared. It may be misspelled. 

No such class: ' identifier' . 

The specified identifier is not a class, but is used in a place where a 
class name is required, such as before the : : operator or in a base- 
specifier-list. 

'struct' or 'class' used on ' enum identifier'. 

The specified identifier is an enum tag, but the keyword struct or 
class was used instead of enum. 

'enum' used on 'class identifier'. 

The specified identifier is a class tag, but the keyword enum was used 
instead of struct or class. 
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Error 1323: 

Error 1324: 
Error 1325: 
Error 1326: 

Error 1327: 
Error 1328: 

Error 1329: 
Error 1330: 


Error 1331: 


Error 1332: 


'identifier' previously declared to be a type-name. 
The specified identifier was previously declared to have some other 
type. 

'identifier' redefined. 

The specified identifier was previously defined in this scope. 

Scoped declaration in parameter list. 

The : : operator cannot be used in parameter lists. 

Label ’label-name’ not defined. 

The specified label appeared as the target of at least one goto 
statement in the previous function, but the label was never defined in 
the function. Labels are defined in a function using the label : 
statement notation. 

Label ' label-name ' previously defined. 

The specified label was defined more than once in the same function. 
Repeated keyword or type name: 'keyword ' . 

A keyword or type name was used more than once within a single 
declaration. 

Conflicting keywords or type names: ' keyword- V and 
' keyword-2 ' . 

An illegal combination of keywords or type names was used in this 
declaration. 

Must be integral, pointer, or member pointer. 

An expression of a non-testable type was used where a testable value is 
required. Testable types are all the integral, pointer and member-pointer 
types. Testable values are required as the first expression of a ? : 
operator and as the test for the if, while, do while, and for 
statements. 

Must be integral. 

An expression of a non-integral type was used where an integral valued 
expression is required. An integral value is required in a case label 
and in the test expression of a switch statement. 

No such conversion. 

An illegal conversion was specified in a cast operator. 
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Error 1334: Expression is not modifiable. 

You have attempted to assign a value to an expression that cannot be 
modified. An lvalue is any expression that can appear on the left side of 
an assignment operation. For example, the result of a cast is not an 
lvalue; therefore, the following statement is invalid: 


long x; 

(short)x ■ 2; /♦ Error 1334 */ 

The following examples also generate this error message: 
(define ADDONE(x) (x)++ 

ADDONEf 12) ; /* Cannot increment a constant */ 

ADDONE(tg); /* Cannot assign to an address */ 

if (func( 10)=j-2) ; /* "==" was intended, not */ 

Sx = Sy; /* Cannot assign to an address ♦/ 


Error 1335: Invalid use of '6' address-of operator {object). 

The address-of operator ( s ) was applied to an object that was not 
addressable. Examples of nonaddressable objects are bitfields and 
register variables. Also, you cannot take the address of an overloaded 
function except as an initializer. 

Error 1336: Cannot initialize ( variable ) with (initializer). 

The initializer is of a type that cannot be converted to a type required 
by the variable it is initializing. 


Error 1337: Preprocessor error. 

The preprocessor has encountered an error that is beyond its 
capabilities to diagnose. 

Error 1338: Unexpected end of file. 

The parser reached the end of the input source before it expected to. 
This may result during error recovery from a previous syntax error in 
the input source. Otherwise, it usually indicates that a closing brace ( J ) 
or semicolon ( ; ) has been omitted at the end of your source. 
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Warning 1339: A non-lvalue array was converted to a pointer. 

Only arrays that are lvalues can be converted to pointers. (See message 
1334 for an explanation of lvalue.) Because the array is not converted 
to a pointer, operator [ ] should not be applied to it because 
operator [] requires a pointer. Also the array should not be 
assigned to a pointer variable. If you want only to access the array, you 
may ignore this warning. However, if you want to alter the value of an 
array element, you should treat this message as an error. 

Error 1340: The base name ' class- V is ambiguous in class 
' class-2' . 

The class class-1 occurs more than once as a base of the second class, 
class-2. 

Error 1342: Conversion from a virtual base class ('class-name ' ) 
to a derived class is not allowed. 

Virtual base classes cannot be converted, either explicitly or implicitly, 
to derived classes. 


Error 1343: 


Error 1344: 


Error 1345: 


Error 1346: 


Error 1347: 


Ambiguous conversion to integral type from 'class 
class-name' . 

The class has defined multiple conversions to an integral type. 
Ambiguous conversion to pointer from 'class class- 
name' . 

The class has defined multiple conversions to pointer. 

Ambiguous conversion to testable from 'class class- 
name ' . 

The class has defined multiple conversions to one or more of arithmetic, 
pointer, or member-pointer types. 

Ambiguous conversion to derived member pointer. 

An ambiguous reference to the derived member-pointer has been found. 
Resolve the ambiguity by qualifying the pointer name with its class 
name. 

Ambiguous conversion of overloaded function 
pointer . 

An ambiguous reference to the overloaded function pointer has been 
found. Resolve the ambiguity by qualifying the function pointer name 
with its class name. 
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Error 1348: Ambiguous conversion to class. 

An ambiguous reference to the class to which conversion is being made 
has been found. For example, you may have a file-scope function that 
has the same name as a class (and hence, the same name as the 
conversion function of that class). 

Error 1349: Ambiguous conversion. 

An ambiguous conversion has been specified. For example, a 
constructor and a function cannot have the same name. 


Error 1350: 


Error 1351: 


Error 1352: 


Error 1353: 


Error 1354: 


Ambiguous function call. 

The function name used in the call is ambiguous. For example, two 
classes may both have a function of the same name and a class name 
has not been used to qualify the function name in the call. 
Overloaded functions (' function- V and 
'function-2' ) used ambiguously in conditional 
expression . 

Two overloaded functions were used as the second and third operands 
to a conditional operator (? :). These overloaded functions have more 
than one function type in common. Cast one or both operands to the 
desired function pointer or member function pointer type. 

Ambiguous common base class: class-name . 

The reference to the base class is ambiguous. Resolve the ambiguity by 
further qualifying each occurrence of this name. 

Ambiguous member name: member-name. 

The expression used to refer to the member refers to more than one 
function, object, type, or enumerator. Resolve the ambiguity by 
qualifying the member name with its class name. 

Non-static member 'member-name' must be used with 
dot, arrow, or address-of operator. 

Non-static members must be used only in the following contexts: 


□ after a dot or arrow operator 

□ as a member-pointer (as in & class-name : :member-name ) 
a within a sizeof or off setof expression 

□ within a non-static member function of a class that contains or 
inherits the member (where the this-> operation is implied). 


Error 1355: 


Value of an undefined class cannot be used. 

You have tried to dereference a pointer to an undefined class. A 
solution is to include the definition of the class before it is used. 
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Error 1356: 


Error 1357: 


Error 1358: 


Error 1359: 


Error 1361: 

Error 1362: 

Error 1363: 
Error 136«: 
Error 1365: 
Error 1366: 


An array may not be the target of an assignment. 
Array assignment (that is, assignment of an array name) is not 
supported in C or C+ +. 

A function may not be the target of an assignment. 
Function assignment (that is, assignment to a function name) is not 
supported in C or C++. 

Cannot operation a pointer to type. 

You cannot add to or subtract from a pointer to void, a function 
pointer, or a pointer to an undefined class. Nor can you use the 
indirection operator (*) on a pointer to void or a pointer to an 
undefined class. The error message explains which of these mistakes 
you have made. 

Typedef names cannot be declared in parameter 
lists . 

A typedef name has been encountered in a parameter list. Move the 
definition of the typedef name outside the parameter list (that is, to 
file scope). 

Cannot take the address of a member of virtual base 
class . 

The s operator cannot be applied to a member of a virtual base class. 
Invalid initializer. 

The initializer is of a type that cannot be converted to a type required 
by the variable it is initializing. 

Invalid use of void. 

Only functions or pointers can be declared void. 

Cast to undefined class not allowed. 

The class to which a cast is made must be previously defined. 

Cannot find offset into non-class. 

Only members of classes can have offsets. 

Cannot find offset into undefined class. 

A class must be defined before the offset of one of its members can be 
taken. 


Error 1367: Invalid use of the scope operator. 

The scope operator ( : : ) can be used only in such expressions as 
C3 : :mem or C 1 : : C2 : : C3 : :mem where C 1 is a class in which class C2 
is declared, C3 is a class declared in C2 , and mem is a member of C3. 
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Error 1368: 


Error 1369: 

Error 1370: 
Error 1371: 

Error 1372: 
Error 1373: 

Error 1374: 
Error 1375: 
Error 1376: 

Error 1377: 


Cannot find the offset of 'object'. 

It is illegal to take the offset of a member function, a static member 
or a bitfield member. In particular, because the number of bits in a 
bitfield may be less than the number of bits in a char, or its number of 
bits may not comprise an integral number of chars, a bitfield in C+ + 
has no size. 

Cannot find offset because class 'class-name' has 
no member named 'member-name ' . 

The second argument to the offset operation must be a member of the 
class specified in the first argument. 

Cannot take the size of an undefined class. 

A class must be defined before its size can be determined. 

Cannot dereference pointer to undefined class. 

A class must be defined before a pointer to an object of its type can be 
dereferenced. 

No such constructor. 

The constructor referred to does not exist. 

'identifier' previously declared as type-1. Cannot 
be defined as type-2. 

A name declared using the union specifier cannot be defined using 
struct or class. Similarly, a name declared as struct or class 
cannot be defined using union. 

No such member ' member-name ’ . 

The identifier referred to is not a class member. 

Member 'member-name' redeclared. 

The specified member of the class has been declared more than once. 
'identifier' not a definable member. 

Only functions and static data members can be defined outside the 
class declaration. 

'this' may occur only in a (non-static) member 
function. 

You cannot use the this keyword outside the context of a non-static 
member function. 
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Error 1378: Cannot create a new value of a function. 

The new operator cannot be applied to a function type. Functions 
cannot be allocated by means of the new operator, although function 
pointers can. 

Error 1379: Cannot create a new value of a reference. 

The new operator cannot be applied to a reference type. Because a 
reference type is not an object, a pointer to it could not be returned by 
operator new. 


Error 1380: 


Error 1382: 


Error 1383: 


Error 1384: 


Error 1385: 


Error 1386: 
Error 1387: 


Error 1388: 


Error 1389: 


Cannot create a new instance of an undefined class. 
A class must be fully defined before the new operator can be used to 
create a new instance of the class. 

Missing array size in expression. 

One or more dimensions of the given array have not been specified. 
Class 'class-name' has no default constructor. 

You cannot use operator new to allocate an array of class objects if 
the class does not have a default constructor. 

Cannot initialize new array. 

An array created by means of the new operator cannot be initialized by 
specifying a brace-enclosed initializer list. 

Cannot delete an object of an undefined class. 

The delete operator cannot be applied to an object whose class has 
not been defined. 

Length expression of array must be integral. 

The size of an array cannot be specified as a floating-point number. 

No match for call to function or overloaded 
operator . 

The argument list given for a function call did not match any of the 
possible parameter lists. 

Missing constructor body. 

A constructor declaration was followed by a colon ( : ), but no 
constructor body ( { ) was found after the colon. 

Non-virtual functions (' function-name ') cannot be 
declared pure. 

Only virtual functions can be declared pure. For more information, 
refer to section r.10.3 in The C+ + Programming Language, Second 
Edition. 
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Error 1391: Uninitialized const identifier. 

A const identifier must have an explicit initialization. 

Error 1392: Uninitialized const identifier or reference: 
identifier . 

A const identifier must be initialized explicitly. The declaration of a 
reference must contain an explicit initializer unless one of the following 
is true: 

□ the extern specifier has been used 

□ the reference declaration is a class member declaration within a class 
declaration 

□ the reference declaration is a declaration of a function parameter or 
function return type. 


Error 1393: Const identifier or reference member 'member-name' 
must be initialized. 

A const identifier or reference must be initialized explicitly. This 
message is caused by a constructor for a class with a const or 
reference member where the const or reference member is not 
initialized with a mem-initializer in the constructor. For more 
information, refer to section r.12.6.2 in The C+ + Programming 
Language, Second Edition. 

Error 1394: Member 'member-name' must have initializer, class 
'class-name' has no default constructor. 

If a class has a constructor (but does not have a default constructor), 
objects of that class must be initialized. A member is initialized by 
including a mem-initializer for it on each constructor for the class 
containing the member. For example, if the type of X : : a is a class with 
a constructor (but no default constructor) you receive this message if 
you omit the a ( 1 0 ) in the following code: 


X: :X( ) : a(10), b(11) 


( . . . ) 
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Error 1395: Base 'class-name' must have initializer, class 
'class-name' has no default constructor. 

If a class has a constructor (but does not have a default constructor), it 
must be initialized. A base class is initialized by including a mem- 
initializer for it on each constructor for the derived class. For example, 
if b is a base class of X and a class with a constructor (but no default 
constructor), you receive this message if you omit the b ( 1 1 ) in the 
following code: 

X: :X( ) : a( 10) , b(11) 


Error 1396: Virtual base class 'class-name' must have 

initializer since class has no default constructor. 
If a class has a constructor (but does not have a default constructor) it 
must be initialized. A virtual base class is initialized by including a 
mem-initializer for it on each constructor for the derived class. The 
example in the explanation of Error 1395 is applicable in the virtual 
base class case as well. 

Error 1397: 'identifier' is not a base class or member of class 

' class-name ' . 

The specified identifier is not a member or base class of the class being 
constructed. 

Error 1398: Member access through protected base class not 
allowed for 'member-name' . 

The specified member cannot be accessed because it has been inherited 
from a protected base class, and the function or initializer using the 
member is not a friend or member of a class derived from that base. 


Error 1399: Member access through private base class not 
allowed for 'member-name' . 

The specified member cannot be accessed because it has been inherited 
from a private base class, and the function or initializer using the 
member is not a friend or member of the class that is derived directly 
from that base. 
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Error 1400: Base access through protected base class not 
allowed. 

The expression that is attempting to access the base class is not in a 
function or initializer that has access to it. Because the base class is 
protected, only functions of the following types have access to the base 
class: 

a members or friends of the class that declared the base class 

□ members or friends of classes derived from the class declaring the base 
class. 

Initializers for members of a class have the same access privileges as 
functions of that class. For more information, refer to section r.11.2 in 
The C+ + Programming Language, Second Edition. 

Error 1401: Base access through private base class not allowed. 

The expression that is attempting to access the base class is not in a 
function or initializer that has access to it. Because the base class is 
private, only functions that are members or friends of the class that 
declared the base class have access to the base class. Initializers for 
members of a class have the same access privileges as functions of that 
class. For more information, refer to section r.11.2 in The C+ + 
Programming Language, Second Edition. 

Error 1402: Cannot access protected member 'member-name' . 

The expression that is attempting to access the member mem is not in a 
function or initializer that has access to it. Because mem is protected, 
only functions of the following types have access to mem : 

□ members or friends of the class that declared mem 

□ members or friends of classes derived from the class declaring mem. 


Initializers for members of a class have the same access privileges as 
functions of that class. For more information, refer to section r.ll in The 
C+ + Programming Language, Second Edition. 

Error 1403: Cannot access private member 'member-name' . 

The expression that is attempting to access the member mem is not in a 
function or initializer that has access to it. Because mem is private, only 
functions that are members or friends of the class that declared mem 
have access to mem. Initializers for members of a class have the same 
access privileges as functions of that class. For more information, refer 
to section r.ll in The C+ + Programming Language, Second Edition. 
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Error 1404: 


Error 1406: 
Error 1407: 

Error 1408: 

Error 1409: 
Error 1410: 
Error 1411: 

Error 1412: 

Error 1413: 
Error 1414: 
Error 1415: 

Error 1416: 


Virtual function 'function-name' declared in 
virtual base 'class-name' must be overridden. 

The virtual function is declared in a virtual base class. It is also 
overridden in at least two classes derived from the base class and 
inherited by the class that caused this message. The specified virtual 
function must be declared in the class that caused this message. 
Parameter of type 'void'. 

Parameters to functions cannot be declared to be of type void. 
Default argument expression missing. 

If a formal parameter has a default argument value, then all the 
parameters after this one must also have default argument values. 
Multiple declarations of function specifying 
default arguments. 

The default argument for a formal parameter can be given in only one 
function declaration. 

Arrays cannot contain elements of type 'void'. 

Array elements must be of some type other than void. 

Arrays cannot contain bitfields. 

Array elements must be of some type other than bitfield. 

Arrays cannot contain functions. 

You can define an array of function pointers, but not an array of 
functions. 

Functions cannot return functions. 

A function can return a function pointer, but it cannot return a 
function. 

Functions cannot return arrays. 

A function can return a pointer, but it cannot return an array. 
Functions cannot return bitfields. 

Bitfields cannot be returned by functions. 

Functions cannot return undefined classes. 

If a function is intended to return a class, that class must first be 
defined. 

Pointers cannot point to references. 

References are not addressable and so cannot be referenced by pointers. 
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Error 1417: 
Error 1418: 
Error 1419: 
Error 1420: 
Error 1421: 
Error 1422: 
Error 1423: 


Pointers cannot point to bitfields. 

Bitfields are not addressable and so cannot be referenced by pointers. 
References cannot refer to references. 

A reference whose value is a reference is not permitted. 
References cannot refer to bitfields. 

A reference cannot refer to a bitfield. 

References cannot refer to objects of type 'void'. 
There are no void objects, so there cannot be a reference to one. 
Member pointers cannot point to bitfields. 

Bitfields cannot be referenced by member-pointers. 

Member pointers cannot point to references. 

A reference cannot be referred to by a member-pointer. 

Member pointers cannot point to objects of type 
' void ' . 


Because there are no void objects, a pointer cannot point to one. 
Error 1424: Bitfields must be of integral type. 

Bitfields cannot be of floating-point type. 

Error 1425: Overloaded functions with indistinguishable 
arguments . 

Two functions have the same name and the same parameter list. Either 
delete one of the functions, or change its definition. 

Warning 1426: KSR C style function definition. 

A Kemighan and Ritchie (K&R) C style function definition has been 
encountered. C+ + requires function definitions to be of prototypical 
form, but K&R style function definitions are permitted as an extension. 
This message is only to warn you about the use of this extension. If you 
do not want to see this warning, use the ignore compiler option to 
turn it off. 


Error 1427: KSR C style functions cannot return classes with 
constructors or destructors. 

If a function is to return a class with a constructor and destructor, it 
must be defined by means of a prototypical function definition, as 
opposed to using a Kernighan and Ritchie (K&R) C style function 
definition. 



Error and Warning Messages 299 


Error 1428: Conversion function must be a member function. 

A conversion function for a class must be defined as a member function. 


Error 1429: Destructor function must be a member function. 

The destructor for a class must be defined as a member function. 


Error 1430: 


Error 1431: 


Error 1432: 


Error 1433: 


Conversion function 'function-name' not correctly 
declared . 

A return type was specified for a conversion function, or formal 
parameters were given for a conversion function. Declarations of 
conversion functions do not specify the return type in the usual way. 

The return type is part of the name of the function. Also, conversion 
functions cannot take arguments. 

Destructor function 'destructor' not correctly 
declared. 

A destructor has been declared to be something other than a function, 
or a return type was specified for a destructor. Destructors must be 
functions and declarations of destructors cannot specify a return type 
(not even void). 

Copy constructor for a class may not take an 
argument whose type is that class. 

Copy constructors cannot take an argument whose type is the class of 
which the copy constructor is a member. Typically, you can copy objects 
of class ABC by declaring a copy constructor of the form 
ABC : : ABC ( const ABCS ) . For more information, refer to section 
r.12.1 in The C+ + Programming Language, Second Edition. 

Operator function 'function-name' not correctly 
declared . 

An operator function must be either a member function or have at least 
one parameter of type class. 
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Error 1434: Invalid linkage specifier. 

The extern keyword must be followed by a string literal containing 
either "C" or "C++". This error may also be caused by an extra or 
misspelled token after an extern keyword. "C" and "C++" must be 
specified in uppercase. 

Error 1435: Linkage differs from prior declaration. 

The linkage specified is not the same as that specified in a prior 
declaration of the function. 


Error 1436: Unknown linkage convention. 

SAS/C C+ + implements only the "C" and "C++" linkage conventions. 
Linkage to other languages must be specified using the SAS/C language 
keywords. 

Error 1437: Missing class name. 

A class name was expected but not found. This may be caused by a 
misplaced comma. 

Error 1438: Repeated base class. 

A base class can be mentioned only once in the base-list. For more 
information, refer to section r.10.1 in The C+ + Programming Language, 
Second Edition. 


Error 1439: Objects of abstract classes ['object-name') cannot 
be declared. 

Classes that have pure virtual functions (abstract classes) can be used 
only as base classes; they cannot be used to declare variables or 
members of other classes. It is permissible to declare pointers to 
abstract classes. 

Error 1440: Object of type 'void'. 

Only a function can be declared to be of type void. A pointer can be of 
type void *. 

Error 1441: Static members {'member-name') of a local class may 
not be initialized. 

This is one of the limitations of local classes. All static data members 
of local classes are automatically initialized to zero. 


Error 1442: Cannot use undefined enum 'identifier'. 

Enumerations must be defined before they can be used. 
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Error 1443: Enum constants ('identifier') must be initialized 
with integral values. 

The values of an enumeration must be integral values (rather than, for 
example, floating-point values). 

Error 1444: A class cannot be a member of itself. 

No member of a class can be of the same type as that class (although a 
class can have as a member a pointer or reference to that type of class). 
Error 1445: Cannot declare members of an undefined class. 

A class must be defined before any of its members can be declared. 
Error 1446: Cannot declare arrays of an undefined class. 

If an array of instances of a given class is to be declared, the class must 
first be defined. 


Error 1447: Cannot declare variables of an undefined class. 

Classes must be defined before objects of that class can be declared. 
Error 1448: Cannot initialize data members in member 
declaration. 

Data members cannot be initialized within the class definition. Non- 
static data members must be initialized in the mem-initializer of each 
constructor function; for more information, refer to section r.9.4 in The 
C+ + Programming Language, Second Edition, static data members 
must be initialized outside the class; for more information, refer to 
section r.12.6.2 in The C+ + Programming Language, Second Edition. 
Error 1449: Member function of a local class must be defined 
within that class: class-name. 


Error 1450: 


A member function of a local class must be defined within that class 
and not merely declared within the class. 

Member 'member-name' declared 'void'. 


A member cannot be of type void. 
Error 1451: 'friend' used on non-function. 


The friend keyword has meaning only in function declarations inside 
a class. 


Error 1452: 'friend' can only be used inside a class. 

The friend keyword has meaning only in function declarations inside 
a class. 



302 Appendix 2 


Error 1453: 


Error 1454: 


Error 1455: 


Error 1456: 


Invalid syntax for access declaration. 

A member declaration contains inconsistent information. Friend 
function declarations require the friend keyword. Access declarations 
cannot specify any type information. Member declarations inside the 
class definition cannot specify the class using the scope operator. Either 
add the friend keyword, remove the type information, or remove the 
class name and scope operator, depending upon which type of 
declaration you intended. 

Invalid access adjustment: ' member -name' . 

Access to a base class member cannot be adjusted in a derived class 
that defines a member of the same name. 

Access cannot be changed, but only reinstated. 

Access declarations must declare the inherited member to have the 
same access as the member in the class from which it is inherited. 
Previously declared as a member in this class. 

An access declaration cannot specify a name defined in the derived 
class. 


Error 1457: ' class : :member' is not a member of a base class. 

The specified member is not a member of any base class. 

Error 1458: Access declaration names class that is not a base 
of this class. 

You have tried to adjust the access to a member of a base class by using 
an access declaration, but the base class name you have used is not 
truly a base class of the derived class. You may have misspelled the 
base class name. 


Error 1460: Constructor function ' constructor ' not correctly 
declared . 

An incorrectly declared constructor has been found. Perhaps you have 
specified a return type for a constructor, or the name used in the 
declaration of the constructor is not the same as the name of the class. 
Declarations of constructors cannot specify a return type (not even 
void ) and the name of the constructor must be the same as the class 


name. 
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Error 1461: Destructor function 'destructor' not correctly 
declared . 

An incorrectly declared destructor has been found. Perhaps you have 
declared it to be something other than a function, or specified a return 
type for the destructor. Destructors must be functions and declarations 
of destructors cannot specify a return type (not even void). The name 
of the destructor must be a tilde C) followed by the class name. 

Error 1462: Operator function 'function-name' not correctly 
declared . 

An incorrectly declared operator function has been found. Perhaps you 
have declared it with the wrong number of arguments. Unary operators 
take only one argument and binary operators take two arguments. Also, 
member functions have an implicit this argument, which counts 
against this limit. So, for example, a unary operator declared as a 
member function has no explicit formal parameters. 

Error 1463: Static functions {'function-name' ) cannot be 
virtual . 

static functions cannot be virtual. Remove the virtual keyword 
from the declaration of the static function. 


Error 1464: Constructors {'constructor') cannot be virtual. 

Constructor functions cannot be virtual. Remove the virtual 
keyword from the declaration of the constructor function. 

Error 1465: Static functions (' function-name' ) cannot be used 
to override virtual functions. 

A static member function was declared to have the same name and 
argument types as a virtual function inherited from a base class. Use a 
different name for the static function. 


Error 1467: Linkage specification cannot be used in a member 
declaration ( 'member-name ' ) . 

Linkage declarations can be used only in file-scope declarations of non- 
members. 
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Error 1468: Cannot define classes or enums in return types or 
parameter lists. 

Classes and enumerations cannot be defined in parameter lists 
(prototypes) or in return type declarations. 

Error 1469: Invalid parameter name 'parameter'. 

Parameter names cannot be operator function names, operator 
conversion names, or destructor names. 

Error 1472: Formal 'argument' is not listed in function 
declaration. 

All arguments to a function must be listed in the parameter list of the 
function. 


Error 1473: 


Error 1474: 


Error 1475: 


Error 1476: 


Initialized local extern 'variable' . 

External variables declared inside a function cannot be initialized in the 
function. Instead, they must be initialized by another declaration outside 
the function. 

Type names (name) cannot be initialized. 

Declarations of typedef names cannot contain initializers. 

Class with constructors must have an initializer. 
Variables declared to be of classes that have constructors must be 
initialized. 

Cannot define classes or enums in type names. 

Classes and enumerations cannot be defined in cast operators, new 
operators, sizeof expressions, or offsetof expressions. 


Error 1477: 


Not a function. 

A file-scope declaration followed by a mem-initializer or a function body 
must declare a function. 


Error 1478 : A mem-initializer may be used only within 
constructor functions. 

This message occurs when a colon follows a function declarator, but the 
function is not a constructor. 
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Error 1479: Base or member 'identifier' re-initialized. 

The same base class or member was initialized by two mem-initializers 
in the same constructor function. For example, the following code 
generates this message because the a ( 1 0 ) part appears twice: 

X: :X{ ) : a( 10) , a(10) 


Error 1480: Old style base initializer cannot be used on class 
with no bases. 

An old style base initializer is a mem-initializer with no specified name. 
They can be used only for classes with a single base class. For example, 
if X has no base classes, the following code tries to initialize a non- 
existent base and generates this message: 

X: :X( ) : (10) 

(...) 

To correct the error, delete the (10) part. For more information, refer 
to section r.18.3.2 in The C+ + Programming Language, Second Edition. 
Error 1481: Old style base initializer cannot be used on class 
with multiple base classes. 

An old style base initializer is a mem-initializer with no specified name. 
They can be used only for classes with a single base class. For example, 
if class X has more than one base, the following code is ambiguous and 
generates this message: 

X: :X( ) : (10) 


To correct the error, insert the name of a specific base class before the 
(10). For more information, refer to section r.18.3.2 in The C+ + 
Programming Language, Second Edition. 

Warning 1482: statement is unreachable. 

The statement flagged will never be executed. You may want to check 
your program logic. 
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Error 1483: 'case' label must be within a switch statement. 

case labels are not allowed outside of a switch statement. 

Error 1484: 'default' label must be within a switch statement. 

The default label is not allowed outside of a switch statement. 
Error 1485: 'continue' must be within a loop ('do', 'for', or 

'while') statement. 

The continue statement is not allowed outside of a loop statement. 
Error 1486: 'break' must be within a switch or loop ('do', 

•for', or 'while') statement. 

The break statement is valid only within switch or loop statements. 
Error 1487: Missing return value. 

The return value of the function was not specified. 

Error 1489: Return value given for constructor, destructor, or 
void function. 


A return value is not allowed in a constructor, destructor, or void 
function. 


Error 1490: Missing function name in function declaration. 

A function name was expected but not found. You may have misspelled 
the name of a constructor function. 

Error 1491: Illegal formal declaration list in prototype 
function definition. 

A function definition included both a prototype and one or more 
Kernighan and Ritchie (K&R) C style argument declarations. These two 
styles cannot be mixed in a single definition. 

Error 1492: Formal ('argument') must be declared in function 
header identifier list. 

In Kernighan and Ritchie (K&R) C style function definitions, formals 
declared in the formal declaration list must have already been specified 
in the identifier list of the function. 
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Error 1493: 


Error 1494: 


Error 1495: 


Error 1498: 


Error 1499: 


Error 1500: 


Error 1501: 


Error 1502: 


Error 1503: 


Expression in array declarator must be constant 
expression. 

Array declarations that specify a size must specify it as a non-negative 
integral constant expression. 

Expression in array declarator must be integral. 

Array declarations that specify a size must specify it as a non-negative 
integral constant expression. 

Expression in array declarator must be positive. 
Array declarations that specify a size must specify it as a non-negative 
integral constant expression. 

Invalid bitfield size. 

Bitfield sizes must be a non-negative constant expression less than or 
equal to the size of the specified allocation unit. 

Cannot use undefined class 'class-name' as base 
class . 

The specified class must be defined before it can be used as a base class 
for another class. 

Missing declaration-specifier. 

Declaration specifiers are required in all non-function declarations. They 
are also required in function declarations in parameter lists. 

Illegal use of 'item' in local member function. 

Local member functions can use type names, static variables, 
extern variables and functions, and enumeration constants only from 
the enclosing scope. 

A class cannot be derived from a union ( ' union- 
name ’ ) . 

A class cannot be derived from a union. 

A union ('union-name') cannot be derived from 
another class. 

A union cannot be derived from another class. 
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Error 1504: 

Error 1506: 
Error 1507: 
Error 1508: 
Error 1509: 


Constant expression contains a division by zero 

( 0 ). 

Constant expressions cannot contain division by zero. 

Cannot take the size of a function. 

Functions have no size, although function pointers do. 

Cannot take the size of a bitfield. 

Bitfield sizes are not expressible in bytes. 

Cannot take the size of void. 

Because there are no void objects, you cannot take the size of one. 
Cannot take the size of array with unspecified 
length. 

The array was declared without giving its length, so its size cannot be 
determined. 


Warning 1510: Cannot jump into a block to a label after a 
declaration having an initializer. 

It is prohibited to jump into a block (using a goto statement) if the 
destination label occurs after a declaration in the same block that has an 
initializer. Should such a jump occur, the object in question would not 
be initialized but could be referenced in subsequent code. 

Error 1511: Overloaded member functions (' function-name ' ) may 
not be both static and non-static. 

All member functions of the same name must be either static or non- 
static. 

Error 1512: Function hides a virtual function from base class. 

Because the function hides a virtual function, the virtual function is not 
called. 


Error 1513: Overriding virtual function has different return 
type. 

An overriding virtual function cannot change the return type. 

Error 1514: Arrays cannot contain references. 

Arrays of references are not allowed. 

Error 1515: Previous declaration of function had different 
return type. 

An earlier declaration of the function specified a different return type. 
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Error 


1516: 


Cannot have two extern "C" functions with same name 
( ' name ' ) . 

In a program, only one of a set of overloaded functions of a given name 
can be declared extern "C". 


Error 1517: Previous declaration differed in the use of 
builtin. 

All declarations of a function must be consistent in the use of the 

builtin keyword. All must have it, or none must have it. 

Error 1518: object-type (' expression •) cannot be used in 
default argument expressions. 

Non-static members, formal parameters, and automatic variables 
cannot be used in default argument expressions. 

Error 1522: Keyword can only be used on functions. 

A keyword that can be used only in function declarations has been used 
in a declaration of some other type. For example, virtual and 
inline can be used only in function declarations. 


Warning 1523: 'keyword' cannot be applied to object-type. 

It is invalid or meaningless to apply the keyword in the specified 
context. For example, it is meaningless to apply a storage class keyword 
such as auto to the definition of a class (although auto can be applied 
to the definition of an object whose type is that class). Depending upon 
the combination of keywords in question, this may be treated as a 
warning or an error. 

Error 1524: Previous declaration was not static. 

A function was first declared non-static and later declared static . 


Error 1525: Function declared 'inline' after first use. 

A function was used prior to its declaration as an inline function. 
Error 1528: Member functions must be C++ functions. 

Only C+ + functions (and not functions in C or in other languages) can 
occur as member functions. 


Error 1530: Previous errors prevent continuation. 

The source program has one or more errors that prevent the 
compilation from continuing. 
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Error 1531: A declaration must declare something. 

An empty declaration has been encountered. This message usually is 
caused by the omission of a variable name in a declaration (leaving only 
a sequence of keywords or type symbols). 

Error 1532: function-name cannot have 'storage-type' storage 
class . 

A member function declared const or volatile cannot also be 
declared static. 


Warning 1533: 


Warning 1534: 


Error 1535: 
Error 1536: 
Error 1537: 
Error 1538: 


Extra comma at end of enumeration list. 

An enumeration list has an extraneous comma after its last member. 
Enum value: value is used for both 'enum-1' and 
' enum-2 ' . 

An enumeration value has been repeated. This warning is given if two 
enum constants in the same enumeration type have the same value. 
This may be what you intended; the warning is given in case it is not 
intended. 

Cannot overload 'main', 
main can not be overloaded. 

Cannot call or take the address of 'main'. 

The function main cannot be called, nor can its address be taken, 
'main' cannot be 'storage-type' . 

The function main cannot be declared static or inline. 
Anonymous classes cannot have constructors or 
destructors . 

An anonymous (unnamed) class cannot have a constructor or a 
destructor. 


Error 1539: Destructor names ( ' destructor ' ) must be the same as 
their class name (’class'). 

The tilde (~) can be used only to declare a destructor if that destructor 
has the same name as the class for which it is a destructor. 

Error 1540: Expression in array declarator must not be 
negative . 

In C+ + , an array must be declared to be of a positive size. As an 
extension, SAS/C C+ + allows the declaration of zero-length arrays. 
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Error 1541: Cannot allocate array of class 'class-name' with no 
default constructor. 

In order to allocate an array of a class with the new operator, the class 
must have a default constructor. 

Error 1542: Invalid constructor given for member 'member-name' . 

An invalid constructor has been encountered. This happens in two 
circumstances: 

□ in constructors that do not give an explicit member initializer for a 
member that is an array of classes without a default constructor 

□ in constructors that give a multi-argument member initializer for a 
non-class member. 


Error 1543: 


Error 1544: 


Error 1545: 


Warning 1546: 


Error 1547: 


Error 1548: 


’ operand- 1 ' and 'operand-2' are not compatible 
types for conditional operator. 

The two operands are not of compatible type for use with the 
conditional operator. 

{type- 1) operator {type-2): Invalid type for binary 
operator . 

One of the types displayed is inappropriate for the operator in question 
or is incompatible with the other type in this context. 

•operand’ is of invalid type for postfix operator 
' operator' . 

The postfix operator ( + + or — ) cannot be applied to an object of the 
given type. 

'operator' is invalid for operand type 'operand'. 
The operator cannot be applied to an operand of this type. Depending 
upon the operator/operand pair in question, this may be either a 
warning or an error. 

' object ' is of invalid type for call operator. 

The call operator, ( ) , cannot be applied to an object of the given type. 
Invalid pointer conversion from 'type-1' to 
' type-2 ' . 

It is not possible to convert a pointer to an object of the given type. 
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Warning 1549: Non-const and/or non-volatile member function 
called with const and/or volatile object. 

It is an error to call a non-const member function for a const object 
or a non-volatile member function for a volatile object, but 
because many other compilers fail to diagnose this error, SAS/C C+ + 
treats it as a warning. Ignoring this warning allows non-const 
functions to change data declared as const. 

Warning 1550: Non-constant reference 'reference-object' 
initialized with a non-lvalue. 

The reference in question is to a non-const but has been initialized 
with something that is not an lvalue. See Error 25 for a description of 
lvalues. 


Error 1551: Cannot take size of pointer to overloaded function 
' function-name ' . 

Because an overloaded function name does not uniquely determine the 
function designated, a pointer to such a function likewise is not uniquely 
determined and consequently its size may be indeterminate as well. 
Accordingly, sizeof cannot be applied to such a pointer. 

Error 1553: Error writing to output file: filename. 

An error lias been encountered in writing to the output file. This could 
be caused by a variety of environmental factors (such as a lack of disk 
space). 

Error 1554: Inline member function does not end. 


Error 1555: 


The end of the input file has been encountered before the closing brace 
( ) ) was seen for a member function. 

Static function ’function-name' was not defined. 


The specified function was declared static but has not been defined 
in this source file. 


Error 1556: Global anonymous unions must be static. 

An anonymous union declared at file scope must be declared as 
static. 
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Error 1557: Anonymous unions may not have function members. 

You cannot define an anonymous union that contains function members. 
If you want function members, use another construct, such as a plain 
union, struct, or class. 

Error 1558: Anonymous unions may not have private or protected 
members . 


You cannot define an anonymous union that contains private or 
protected members. If you want private or protected members, use 
another construct, such as a plain union, struct, or class. 

Error 1559: 'identifier' redeclared in anonymous union. 

The specified identifier was previously declared to have some other 
type. 

Error 1560: An anonymous union cannot be declared as a static 
member . 


An anonymous union has no name for linkage to the definition. 
Error 1562: Conflicting declaration of name 'identifier' 
reserved for purpose. 

You have inadvertently used a name that the compiler reserves for its 
own uses. Choose another name. 


Error 1564: Cannot initialize a function {'function-name'). 

You cannot initialize a function. You can initialize only variables. 

Error 1565: Static members (member-name ) cannot be initialized 
by a mem-initializer. 

Static members should be initialized by the definition of the static 
member outside the class. For example, this message is issued if you 
use the following code and a is a static member: 


X: :X( ) 


a(10) 


( . . . ) 
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Error 1566: Enum constants (identifier) cannot be initialized 
by a mem-initializer. 

Enum constants should be initialized inside the enum declaration, as 
they are in C. For example, this message is issued if a is an 
enumeration constant: 


X: :X( ) 


a( 10) 


Error 1567: 


Error 1568: 


Types must match in a delete expression: type-1- 
>~type-2 . 

When calling a destructor for a built-in type, it is required that the two 
types specified in the call be the same. 

Cannot create a new value of a void. 


The new operator cannot be applied to void. Because void is not an 
object type, a pointer to it could not be returned by operator new. 
Error 1569: Loop in -> operators. 

The pointed-to expression uses a user-defined operator -> that either 
returns the class that contains the operator, or returns a class that 
contains another operator -> which in turn returns the class containing 
the original operator ->. The loop might be more complicated, but in 
any event the sequence leads back to the original operator ->. 

Error 1570: A linkage-specification may occur only in file 
scope . 

Linkage-specifications are not permitted in block scopes, class scopes, or 
function scopes. 
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Error 1571: Cannot define a type in return or argument types. 

A type (for example a struct tag) cannot be defined in an argument 
list or in the specification of the return type. 

Error 1572: object may not have the same name as its class. 

A static data member, enumeration, member of an anonymous 
union, or a nested type cannot have the same name as its class. For 
more information, refer to section r.9.2 in The C+ + Programming 
Language, Second Edition. 

Error 1573: An overloaded operator cannot have default 
arguments . 

It is illegal to declare overloaded operators with default arguments. For 
example, int operator +( int=3 , int=4 ) is not a valid 
declaration. For more information, refer to section r.8.2.6 in The C+ + 
Programming Language, Second Edition. 


Error 1574: Invalid use of abstract class: class-name. 


An abstract class cannot be used as an argument type, a function return 
type, or the type of an explicit conversion. 

Error 1575: An object of a class with a object-type may not be 
a member of a union. 

An object of a class with constructors, destructors, or user-defined 
assignment operators cannot be a member of a union. For more 
information, refer to section r.9.5 in The C+ + Programming Language, 
Second Edition. 


Error 1576: Error declaring 'new': reason. 

operator new must have a return type of void*. Its first argument 
is required and must be of type size_t. For more information, refer 
to section r.12.5 in The C+ + Programming Language, Second Edition. 

Error 1577: Error declaring 'delete': reason. 

The delete function must have return type void. Its first argument 
must be of type void* and if there is a second argument, it must be of 
type size_t. No more than two arguments are permitted. For more 
information, refer to section r.12.5 in The C++ Programming Language, 
Second Edition. 
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Error 1578: Initializer-clause cannot be used for class having 
a object-type. 

A class having a constructor, a private or protected member, a base 
class, or a virtual function is not an aggregate and cannot be initialized 
by means of an initializer-clause (for example, = (10,2,10.2)). For 
more information, refer to section r. 8.4.1 in The C Programming 
Language, Second Edition. 

Error 1579: Conversion to a virtual base class ( ' class-name ' ) 
from a derived class is not allowed for member 
pointers . 

Virtual base classes cannot be converted, explicitly or implicitly, from 
derived classes. 


Error 1580: Cannot return ( attempted-return-type) from function 
returning ( declared-return-type ) . 

The return value is of a type that cannot be converted to a type 
required by the function’s return type. 

Error 1581: Function 'function-name' has an initializer. 

Functions cannot be initialized, although function pointers can be 
initialized. 


Error 1582: Character array ( array-name ) too short for string 
of length ( string-length ). 

A character array cannot be initialized by a string that has more 
characters than the array has elements. 

Error 1583: Too many initializers for (array-name): found n 
initializers . 

No array can be initialized with more initializers than the array has 
elements. 


Error 1584: Too many initializers for (class-name). 

No class can be initialized with more initializers than the array has 
members. 

Left operand of 'operator' must be type. 

The left operand of the dot operator ( . ) must be a class object. 


Error 1585: 
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Error 1586: 

Error 1587: 
Error 1588: 
Error 1589: 
Error 1590: 

Error 1591: 

Warning 1592: 


Type 'type' is invalid for the left operand of 
' operator’ . 

The left operand of the arrow operator (->) must resolve to a class 
pointer. 

Case label value must be a constant expression. 

You have used a non-constant expression as a case label. 

Duplicate case label value. 

The same case label occurs more than once within a switch statement. 
More than one default. 

There is more than one default label in a single switch statement. 
symbol-name is not an enum. 

The specified symbol was used after the enum keyword, but is not an 
enumeration. 

symbol-name is not a class, struct, or union. 

The specified symbol was used after a class, struct, or union 
keyword, but is not a class, struct, or union. 

Wide and narrow character strings concatenated, 
using width. 

Wide characters strings are of the form L"abc", narrow characters 
strings are the usual "abc". These two types of strings should not be 
concatenated together. For example, neither of the following statements 
is valid: 


"abc" L"def" /* wrong */ 

L"abc" "def" /* wrong */ 

If the first string in the concatenation is wide, the result is wide. 
Similarly, if the first string is narrow, the result is narrow. 
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Warning 1593: Missing return statement. 

A return statement is missing at the end of the outer block of a 
function, and a return value is required. 

Warning 1594: Zero-length array used. 

Zero-length arrays are allowed in classes (types class, struct, and 
union) as an extension of standard C and C+ + . This message is only 
to warn you about the use of this extension. If you do not want to see 
this warning, use the ignore compiler option to turn it off. 

Error 1610: Previous declaration of 'symbol' was 'attribute' , 
this declaration is 'attribute'. 


An attribute of a symbol was declared differently in a previous 
declaration. For example, the previous declaration may have been 

declared with near, but this declaration of the same symbol 

specified far. Make the declarations consistent. 

For some attributes, C+ + applies a default if the attribute was not 
explicitly specified in the declaration. A declaration with a specific 
keyword may conflict with a previous declaration with no keyword 
depending on the current defaults. The default attributes applied by 
C+ + depend upon the specific attribute and any compiler options you 
specify. 

Error 1611: Previous declaration of 'symbol' differed in the 
use of 'keyword'. 

An attribute of a symbol was declared differently in a previous 
declaration. Either the previous declaration used a keyword that is not 
present in this declaration or did not use a keyword that is present in 
this declaration. For example, the previous declaration may have been 

aligned, and this declaration is not. Make the declarations 

consistent. 


For some attributes, C+ + applies a default if the attribute was not 
explicitly specified in the declaration. A declaration with a specific 
keyword may conflict with a previous declaration with no keyword 
depending on the current defaults. The default attributes applied by 
C+ + depend upon the specific attribute and any compiler options you 
specify. 

Error 1612: Asm function has parameter without a register. 

All parameters to a function declared with asm must be passed in an 

explicitly specified register. 
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Error 1613: Asm function uses register 'Xs' more than once. 

More than one parameter to an asm function used the same register. 

C+ + uses some registers to pass internal arguments to functions 

declared with asm. If there is a conflict between the registers you 

specify and the registers needed by the translator, this message is 
displayed with an explanation of the conflict. 

Error 1614: Previous declaration of asm function used different 
registers, was '%s', now '%s'. 

Functions declared with asm must specify the same registers each 

time the function is declared. 


Error 1615: Explicit register 'register' keyword used in non- 
asm function. 

Explicit registers can only be used on parameters for functions declared 
with the a sm keyword. 

Error 1616: Vararg functions cannot be ' asm'. 

Variable argument functions cannot be declared with the asm 

keyword. Variable argument functions are those functions that take an 
ellipsis (. . .) in their prototype. 
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Explanations of Linker Messages 


Error 


Error 425: 

Error 426: 
Error 443: 
Error 444: 
Error 445: 
Error 446: 

Error 447: 
Error 448: 

Error 449: 
Error 450: 


Out of memory! ! 

slink has run out of memory. By default, slink attempts to cache 
the object modules in memory between pass 1 and pass 2. If slink 
runs out of memory, it attempts to free the cached object modules. In 
some cases, slink cannot find enough contiguous memory. Try adding 
bufsize 4096 to the slink command. This option turns off object 
module caching. 

Cannot find library library-name 

The linker cannot find the specified library. Usually, SAS/C libraries are 
located in the LIB: directory. You may have misspelled the library 
name in your slink command. 

Cannot find object name 
The linker cannot find the specified object. 
filename is an invalid file name 
The linker found an invalid character in a filename. 

Hunk_Symbol has bad symbol-type symbol symbol-name 
The object module is corrupt. Try recompiling the object module. 
Invalid HUNK — SYMBOL symbol-name 
The object module is corrupt. Try recompiling the object module. 
Invalid symbol type symbol-type for symbol-name 
Either the object module is corrupt, or slink has found a symbol type 
that it does not recognize. Try recompiling the object module. For a list 
of valid symbol types, refer to the description of object file structure in 
The AmigaDOS Manual, 3rd Edition, 
filename is a load file 

The file specified is an executable module instead of and object module. 
filename is not a valid object file 
The file specified is not an object module. The file may be a C source 
file or a corrupt object module. 

No hunk_end seen for filename 

The object module is corrupt. Try recompiling the object module. 
Object file filename is an extended library 
A library file was specified as an object module. Add the library 
keyword in front of the library name. 
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Error 501: Invalid Reloc 8 or 16 reference 

An 8- or 16-bit relocation address cannot reach its destination. The 
SAS/C Compiler does not generate 8-bit relocation records, but third 
party products may use them. The object module is probably corrupt. 
Try recompiling your source file. If recompiling the file does not correct 
the error, contact the Technical Support Division. 

Error 502: function-name symbol - Distance for Reloc16 greater 
than 32768 

The distance from the point where the function is called to the function 
itself is greater than 32767 bytes. The function cannot be referenced 
with a 16-bit address field. Normally, slink tries to insert an ALV 
(Automatic Link Vector) at the end of the calling module, but if the 
module has more than 32K of code, the relocation may not reach the 
ALV. An alv is the instruction used to reach functions that would 
otherwise be too far away. Compile the file with code=far, or declare 
the function with the far keyword. 

Error 503: function-name symbol - Distance for Reloc8 greater 
than 128 


The distance from the point where the function is called to the function 
itself is more than 128 and so the function cannot be referenced with 
an 8-bit address field. The SAS/C Compiler does not generate 8-bit 
relocation records, but third party products may use them. 

Error 504: variable-name symbol - Distance for Data Reloc 16 

greater than 32768 

The distance for the 16-bit relocation is too far. You may see this 
message if a data item (such as a structure or an array) is larger than 
64K or if the total amount of data in your program is greater than 64K. 
To correct the problem, you can either break the data item down and 

make it smaller than 64K, or you can place the far keyword on the 

definitions of one or more data items to force all references to those 

items to be 32-bits. Using the far keyword reduces the amount of 

data in the near data section to less than 64K. You can also compile 
your program with the data = far option. However, using data = f ar 
increases code size and execution time. 


Error 505: variable-name symbol - Distance for Data Reloc8 

greater than 128 

The distance for the 8-bit relocation is too far. The SAS/C Compiler 
does not generate 8-bit relocation, but third party products may use 
them. 
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Error 506: Can’t locate resolved symbol symbol-name 

If this message appears, please contact the Technical Support Division. 
See Chapter 3, “Getting Help,” for a complete list of items that you 
need to provide to the Technical Support staff. 

Error 507: Unknown Symbol type symbol-type , for symbol 
symbol-name 

Either the object module is corrupt, or slink has found a symbol type 
that it does not recognize. Try recompiling your source file. For a list of 
valid symbol types, see the description of object file structure in The 
AmigaDOS Manual, 3rd Edition. 


Error 508: Symbol type symbol-type unimplemented 

Either the object module is corrupt, or slink has found a symbol type 
that it does not recognize. Try recompiling your source file. For a list of 
valid symbol types, see the description of object file structure in The 
AmigaDOS Manual, 3rd Edition. 

Error 509: Unknown hunk type symbol-type in Pass2 

If this message appears, please contact the Technical Support Division. 
See Chapter 3, “Getting Help," for a complete list of items that you 
need to provide to the Technical Support staff. 

Error 510: symbol-name symbol - Near reference to a data item 
not in near data section 


The linker expected the specified symbol to be in the near data section, 
but the symbol is located in either the far data section, chip memory, or 
the code section. 


You may have defined a variable as far with the far 

keyword in one module and externally declared the same variable in 

another module without the far keyword. If so, the module with 

the external declaration attempted to reference the data as near. To 
correct the problem, the definition and all declarations of the data item 
must be specified with the same keywords. 

If you compiled your file with the data=auto option, the compiler 
can place variables into the far data section if necessary. The compiler 
may have placed a variable in one module in the far section and a 
variable in another module in the near section. To correct this situation, 

either stop using the data=auto option, or use the far keyword 

(if necessary) on the definition and all declarations of the variable that 
caused the error. 
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Error 512: Invalid branch to function-name in overlay node 
module-name 

The linker detected a branch in an overlay node that calls another 
overlay node at the same level. This type of branch is not supported by 
the overlay manager. 

Error 513: Multiple NTRYHUNK segments not permitted 

The NTRYHUNK is the root overlay node. No other hunks should have 
this name. 

Error 514: Overlay manager _ovlyMgr is undefined 

This _ovlyMgr function is located in SAS/C libraries. To use the 
SAS/C overlay manager, link with sc. lib or scs.lib. You can also 
write your own overlay manager. See Chapter 8, “Compiling and 
Linking Your Program,” for information on creating your own overlay 
manager. 

Error 515: An ALV was generated pointing to data variable-name 
symbol 

A 16-bit relocation could not reach its destination, so slink inserted 
an ALV (Automatic Link Vector) instruction, and then determined that 
the destination is not in a code hunk. To correct the problem, make the 
reference a 32-bit reference. This error may be generated for object 
code produced by third-party assemblers and compilers 

Error 516: Attempt to merge BSS with CODE or CODE/DATA 

Either you have attempted to merge the far BSS section with the far 
data section, or you have attempted to merge the near or far BSS 
section with the code section. You can merge a BSS section with the 

merged section only. You will see this message if you have assigned 

the same name to either the far BSS section and the far data section or 
the far BSS section and the code section. 

If you get this error in another situation, please call the Technical 
Support Division. 

Note: Do not name the code section MERGED. 

Error 600: Invalid option command 

The option listed is not a valid slink option. 

Error 601: option option specified more than once 
The option has been specified twice. 
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Error 602: 


Error 603: 

Error 604: 
Error 605: 
Error 607: 

Error 608 : 
Error 609: 
Error 610: 
Error 611: 


Error 612: 


Unable to open output file filename 

slink cannot open the output file for write access. Another program 

such as CodeProbe may have left a lock on the file. Alternatively, the 

protection bits may prohibit write access to the file, or the name 

specified may be a directory. 

string is not a valid number 

The linker found a non-numerical character in a field where it expected 

to find a number. 

with file is not readable 

The with file may contain binary characters or may be locked. 

Cannot open with file filename 
The with file does not exist or may be locked. 

No FROM/ROOT files specified 

You did not specify an object module, or if you are using overlays, the 
root node did not contain any objects. 

Premature EOF encountered 

The object module is corrupt. Try recompiling the source file. 

Error seeking in file filename 
The object module is corrupt. Try recompiling the source file. 
module-name has no parent in overlay tree 
The with file specifies an overlay with no parent node. 

Reloc found with odd address for symbol symbol- 
name, file filename 

The linker has found a relocation record with an odd address. This 
message can only be generated if your program is written in assembler 
and is usually caused by placing an odd length character string in the 
code section. 

MERGED Data relocation to non-code section in 
Overlay Node 

Reference at offset hex-address in module-name , To 
Unit module-name 

The linker found a relocation from the near data section, which is 
placed in the root node, to the data section of an overlay node. This 
type of relocation is illegal. 
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Error 613: MERGED Data relocation to static function is not 
resolvable by Overlay Manager. 

Reference at offset hex-address in filename , To 
Unit filename 

The overlay manager cannot resolve an indirect function call from the 
root node to a static function in a overlay node. To correct the problem, 
remove the static keyword from the function declaration. 

Error 6 1 <1 : More than one MERGED data section found 

Only one near data section is allowed. This error occurs only when 
using slink to strip debug information from an executable generated 
by a third party linker. If you get this message, do not use slink to 
strip debug information from this executable. 

Error 615: Code hunk named MERGED 

slink merges all hunks with the name MERGED and performs 

relocations to this hunk relative to register A4. Do not name the code 
hunk MERGED . 


Error 616: ALVs were generated 

You have linked with the noalvs linker option, but the linker could 
not resolve all relocations without generating ALV instructions. Either 
the total code size is greater than 32K, or there are multiple code 
hunks. The executable will run, but the code section is not totally PC- 
relative. 


Error 617: MERGED data section greater than 64K 

If your program does not generate any additional messages, then the 
program will still run. However, a 16-bit data relocation record may 
not be able to reach its target, and if this happens, slink will generate 
an error. 


Error 618: Multiple OVERLAY usage— previous occurrences were 
ignored 

You can only specify one overlay manager. 

Error 619: Ignoring null OVERLAY list 

You did not specify any files in the overlay list. 
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Error 620: Missing at end of OVERLAY list 

Enter a pound sign (#) at the end of the overlay tree. For more 
information on creating overlay trees, see Chapter 8, “Compiling and 
Linking Your Program.” 

Error 621: Conflicting integer sizes found 

Some modules were compiled using short integers and some were 
compiled using long integers. You cannot mix integer sizes in an 
executable. Alternatively, you may have linked in the wrong version of 
the library. 


Error 622: Conflicting math types found 

You may have compiled the various object modules with conflicting 
math options. All object modules must be compiled with the same math 
library. Alternatively, you may have linked in the wrong math library. 

Error 623: Regargs function function called through overlay 
manager. Parameters passed in registers to this 
function will be destroyed. 

The regargs function passes parameters in scratch registers, but the 
overlay manager does not preserve scratch registers. You cannot call a 
regargs function across an overlay node. 


Warning 624: Absolute reference to symbol module: file filename 
If you reference far data in a module linked with cres . o or when you 
are generating a shared library, your program may function improperly 
unless the data are read-only, slink cannot determine if the reference 
is read-only, so it generates this warning. 

Error 625: Proper math library has not been included 

You have not linked in the math library that is needed for the current 
math options. If you compile with the link option, you need to include 
the appropriate math option to specify the math library with which you 
want to link. If you are using the slink command to link your file, 
you need to link with a math library as well as sc . lib. 

Error 626: Libcode used on module module 


You have compiled the module with the libcode compiler option, but 
the module is being linked into an executable. Use the libcode option 
for generating shared libraries only. 

Error 627: Near references found in executable that has a 
module compiled with FARONLY option 
You cannot mix modules compiled with data = f aronly and modules 
that refer to near data. 
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Enabling Suppressed Messages 

Many messages are suppressed by default. The strict and ansi 
compiler options turn on some of these messages, but you must use the 
warn option to enable the remaining messages. The ansi option enables 
the following messages: 

18 51 70 108 111 137 162 176 180 213 

The strict option enables the following messages: 

18 70 111 137 162 164 178 180 202 220 

51 108 120 159 163 176 179 187 213 

The following messages can be enabled only with the warn option: 

22 61 112 116 148 149 165 190 212 

The following table lists each message that is suppressed by default and 
indicates which compiler options enable the message. 


Number Message Text 

18 sizeof operator used in preprocessor 

condition 

22 structure used as function argument 

51 C++ comment detected 

61 undefined struct/union tag "tag-name" 

70 unrecognized escape sequence 

108 zero-length arrays are not an ansi feature 

111 non-portable enum type specified 

112 include file "filename" not in GST 

116 undefined enum tag "name" 


ansi strict warn 
XXX 

X 

XXX 

X 

XXX 

XXX 

XXX 

X 

X 


( continued ) 
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120 

137 

148 

149 

159 

162 

163 

164 

165 
176 

178 

179 

180 

187 

190 

202 

212 

213 

220 


Message Text ansi strict 

Integral type mismatch: possible portability X 

problem 

Expecting "type?", found "type2" 

ansi limits #line numbers to between 1 and X X 
32767 

use of incomplete struct/union/enum tag 
"name" 

See line number file filename 

incomplete struct/union/enum tag in prototype 


scope "name" 

use of unary minus on unsigned value X 

non-ansi use of ellipsis punctuator X X 

initialization of auto struct, union, or X 

array 

6 applied to array X 

use of narrow type in prototype 

implicitly promoted formal "name" conflicts X X 

with prototype 

See line number file "filename" 

indirect call without indirection operator X 

narrow type used in old-style definition X 

no space between macro name and its X X 

replacement list 

negative value assigned to unsigned type X 


Sinclude ignored because header already 
included 

See line number file "filename" 

relational comparison between unsigned and X 

zero 

item "name" already declared 
See line number file "filename" 

empty argument to preprocessor macro X X 


warn 

X 


X 


X 


X 

X 

X 

X 


X 

X 

X 


X 

X 

X 


old-fashioned assignment operator 
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Introduction 

The American National Standard for Information Systems — Programming 
Language — C (ANSI Standard X3J1 1/90-013) allows an implementation 
to define its own behavior in certain areas. Implementation-defined 
behavior is defined by the ANSI C Standard as “behavior, for a correct 
program construct and correct data, that depends on the characteristics of 
the implementation. . .” (p.3). 



330 Appendix 3 


Currently, there is not an ANSI Standard for the C+ + language. The 
C+ + language accepted by the translator corresponds to that specified 
by Bjame Stroustrup in the The C+ + Programming Language, Second 
Edition (with some additions added by the ANSI committee working on 
the C+ + standard and with the exception of templates, exception 
handling, and member-pointers in virtual base classes). The C+ + 
language as defined in Stroustrup’s book allows implementation 
dependent behavior in certain areas. 

This appendix describes the implementation-specific behavior for the C 
and C++ languages accepted by the SAS/C Development System. 


C Language 

The following sections describe the SAS/C Compiler behavior for those 
areas listed in Section F.3, “Implementation-Defined Behavior,” of the 
ANSI Standard for the C language. This information is organized like 
Section F.3. 

F.3.1 Translation □ Diagnostics consist of a line printed to the standard output stream 
containing the following elements: 

filename line class number: text 

where: 

filename is the name of the file that caused the diagnostic 
line is the number of the line that caused the diagnostic 
class is either Error or Warning 
number is an integer identifying the diagnostic 
text is the diagnostic text. 

Some diagnostics contain additional information in a second line. If 
present, this second line is indented to the same position as the text 
portion of the first line. 

F.3.2 □ The compiler conforms to the ANSI C Standard for a hosted 
Environment environment as documented in Section 2.1.2.2 of the ANSI C Standard, 
plus the extension of accepting a WBStartup structure as described 
under main in the SAS/C Development System Library Reference. 

□ The compiler recognizes the streams stdin, stdout, and stderr as 
interactive devices. 
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F.3.3 Identifiers 


F.3.4 Characters 


F.3.5 Integers 


□ By default, the number of significant characters for identifiers without 
external linkage is 31. However, this number can be changed to any 
value up to 255 with the idlen compiler option. 

□ The number of significant characters for identifiers with external 
linkage is the same as the number for identifiers without external 
linkage. 

□ Case distinctions are significant in identifiers with and without external 
linkage. 

□ The source and execution character sets consist of the characters 
required by the ANSI C Standard. In addition, national characters 
(characters with accents) are accepted as valid alphabetic characters 
unless the ansi compiler option is used. See The AmigaDOS Manual, 
3rd Edition (Commodore-Amiga, Inc. 1991) for a complete definition of 
the Amiga character set. 

□ No shift states are used for encoding multibyte characters. 

□ Each character in the execution character set consists of 8 bits. 

□ The source character set maps 1-to-l to the execution character set. 

□ All wide character constants map directly into the execution character 
set. Thus, all wide character constants have the same value as their 
corresponding character in the execution character set. 

□ The C locale is used as the current locale. 

□ A plain char item is by default signed, but this default can be 
changed to unsigned with the unschar compiler option. 

□ Integers are represented by two’s-complement numbers. The range of 
possible values are specified in the header file limits .h and in 
Chapter 12, “How the Compiler Works” The most-significant bit in the 
representation of signed integers is the sign bit and determines 
whether the number is positive or negative. 

□ When an integer is converted to a shorter signed integer, the high- 
order bytes are discarded. The bit pattern of the remaining bytes is 
unchanged. The bit pattern of an unsigned number is not changed 
when it is converted to a signed integer of equal length. 

□ The following list covers the results of bitwise operations on signed 
integers: 

" (bitwise NOT) 

The bits are inverted; that is, 1 bits are set to 0, 0 bits are 
set to 1. 

>> (shift right) 

The bits are shifted to the right. The sign bit (uppermost bit) is 
used to fill the vacated bit positions on the left. 
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« (shift left) 

The bits are shifted to the left. The vacated bit positions on the 
right are filled with zeroes. 

& (bitwise AND) 

If the corresponding bits in both operands are 1, then the 
corresponding bit in the result is set to 1; otherwise, it is set to 0. 
I (bitwise OR) 

If either of the corresponding bits in the operands are 1, then the 
corresponding bit in the result is set to 1; otherwise, it is set to 0. 
“ (bitwise XOR) 

If the corresponding bits in the operands are not alike, then the 
corresponding bit in the result is set to 1; otherwise, it is set to 0. 

□ In integer division, the remainder is either 0 or has the same sign as 
the dividend. 

□ In a right shift of a negative-valued signed integral type, the sign bit is 
used to fill the vacated bit positions on the left. That is, the result 
retains the sign of the left operand. 

F.3.6 Floating- □ Floating-point numbers are represented using the IEEE standard 

Point representation, unless the math=f fp option is on. In the latter case, 
the Motorola Fast Floating Point representation is used. The range of 
possible values for floating-point numbers is specified in the header file 
float.h and in Chapter 12, “How the Compiler Works” 

□ If an integral number is converted to a floating-point number that 
cannot exactly represent the original value, the number is rounded for 
all math options except math- coprocess or. For 
math=coprocessor, the number is truncated. You can change the 
behavior for the math-coprocessor option by modifying the source 

code to the fpinit.c function, located in sc : source/_f pinit. 

However, choosing another rounding mode affects the conversion from 
floating-point to integer such that the conversion does not adhere to the 
ANSI C Standard. Specifically, the following statement might assign the 
integer value 6 to i if you specify math-coprocessor, and the 
coprocessor’s rounding mode is not set to truncate: 

int i = ( int ) 5 . 5 ; 

□ Conversions from double to float round or truncate in the same 
manner as conversions from integral types to floating-point types. 
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F.3.7 Arrays and 
Pointers 


F.3.8 Registers 


F.3.9 Structures, 
Unions, 
Enumerations, 
and Bit-Fields 


□ The type of integer required to hold the maximum size of an array is 
unsigned int. 

□ When a pointer is converted to integer, the resulting bit pattern is 
as if an object of type unsigned long with the same bit pattern as 
the pointer had been converted to the integer type. 

□ When an integer is converted to a pointer, the resulting bit pattern is 
the same as if the integer had been converted to an unsigned long. 

□ Under normal circumstances, there can be up to 4 integer register 
variables, 3 pointer register variables, and 5 floating point register 
variables. Using the cover compiler option, the stackext compiler 

option, the stackext keyword, or aligned keyword on a 

function definition costs one pointer register variable. Using the 
data=faronly compiler option adds an additional pointer register 
variable. The register keyword is ignored when the global optimizer 
is used because registers are allocated to variables by the global 
optimization phase. If you specify the autoreg option, the code 
generator selects additional register variables for you if registers are 
available after assigning your choices to registers. 

□ If a member of a union is accessed using a member of a different type, 
the result is undefined. If optimization is used, the compiler may 
attempt to keep the value stored in one member of a union in a 
register, and a subsequent access to a different member may get an old 
value. 

□ Structure members of type char can appear at any byte offset. 
Structure members of other simple types must be aligned on an even 
byte boundary, and padding is inserted if necessary. Any structure or 

union member declared with the aligned keyword is aligned on a 

four-byte boundary, relative to the start of the structure or union, with 
padding inserted as necessary. Substructures and subunions have the 
same alignment requirements as their most restrictive members. 
Structures and unions are padded at the end to the boundary of their 
most restrictive member. For more information on structure padding, 
see Chapter 13, “Writing Portable Code.” 

□ int bitfields are treated as unsigned int bitfields. 

□ The order of allocation of bitfields for an int is from left to right. 
Bitfields never cross storage unit boundaries. 

□ The values of an enumeration type are normally of type int. However, 
the SAS/C Compiler allows the declaration of char enum, short 
enum, and long enum types. Enumeration types so declared are of 
the specified type. For more information on using enumerated types, 
see Chapter 11, “Using SAS/C Extensions to the C and C+ + 
Languages." 
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F.3.10 Qualifiers 


F.3.11 

Declarators 

F.3.12 

Statements 

F.3.13 

Preprocessing 

Directives 


□ Any reference to an object whose type is qualified by the keyword 
volatile is considered an access to that object. 

□ There is no limit on the number of declarators that can modify an 
arithmetic, structure, or union type. 

□ There is no limit to the number of case values in a switch 
statement. 

□ The value of a single-character constant in a constant expression that 
controls conditional inclusion matches the value of the same character 
constant in the execution character set. Such a character can have a 
negative value unless the unschar compiler option is active. 

□ The compiler defines a search path for # include files that are 
included with angle brackets (<>) around their names. This path is 
defined as follows: 

1. directories specified with the includedirectory compiler 
option 

2. the logical assignment INCLUDE : . 

□ The compiler uses a slightly different search path for ((include files 
that are included with double quotes (“") around their names. This 
path is defined as follows: 

1. the current directory 

2. the directory of the file containing the ff include statement 

3. directories specified with the includedirectory compiler 
option 

4. the logical assignment INCLUDE:. 

a Source file character sequences are not mapped. The string between the 
angle brackets (<>) or double quotes (“") is passed to the file system. 

□ The behavior of the libcall, syscall, and tagcall ((pragma 
directives is described in the SAS/C Development System Library 
Reference. The behavior of the msg and f libcall ((pragma 
directives is described in Chapter 11, “Using SAS/C Extensions to the 
C and C++ Languages.” 

□ The definitions for the DATE and TIME preprocessor 

macros contain the date and time as specified by the Da test amp 
AmigaDOS function. This function always returns a value, so the date 
and time are always available. 
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F.3.14 Library □ The NULL pointer constant to which the macro NULL expands is OL. 

Functions □ The diagnostic printed by the assert function is of the form: 

Assertion ( condition ) failed in file filename at line number 
where: 

condition is the condition passed to the assert macro 

filename is the current value of FILE 

number is the current value of LINE 

The assert function calls abort after printing the above line. For 
more information, refer to the description of the assert function in 
the SAS/C Development System Library Reference. 

□ The sets of characters tested for by the isalnum, isalpha, 

iscntrl, islower, isprint, and isupper functions is defined by 

the entries in the external array ctype. The following table lists 

the hexadecimal values for each of the characters tested for by these 
functions. 


Function Name 

Character Type 

Hexadecimal Values 

isalnum 

alphabetic or 

0x30 to 0x39, 0x41 to 0x5a, 


numeric 

0x6 1 to 0x7a 

isalpha 

alphabetic 

0x4 1 to 0x5a, 0x61 to 0x7a 

iscntrl 

control 

0x00 to Ox 1 f , 0x7f 

islower 

lowercase 

0x61 to 0x7a 

isprint 

printable 

0x20 to 0x7e 

isupper 

uppercase 

0x41 to 0x5a 


□ The mathematics functions return zero on domain errors. 

□ On underflow range errors, the mathematics functions set the integer 
expression err no to the macro E RANGE. 

□ Zero is returned when the fmod function has a second argument of 
zero. 

a The set of signals for the signal function are the minimum set 
defined by the ANSI C Standard: SIGABRT, SIGFPE, SIGILL, 
SIGINT, SIGSEGV, and SIGTERM. 



Refer to the description of the signal function in the SAS/C 
Development System Library Reference for the semantics of the signals. 
By default, the SIGINT signal results in calling the _CXBRK function, 
which terminates the program. Also by default, the SIGFPE signal 
results in calling the _CXFPE function, which sets errno and returns 
to the caller causing the exception. By default, all other signals are 
ignored. 

The default handling is reset if the SIGILL signal is received by a 
handler specified to the signal function. 

The last line of a text stream does not require a terminating newline 
character. No newline character is generated if one is not explicitly 
written. 

Space characters that are written out to a text stream immediately 
before a newline character appear when read in. 

The implementation does not append any NULL characters to data 
written to a binary stream. 

The file position indicator of an append mode stream is initially 
positioned at the beginning of a file. 

A write on a text stream does not cause the associated file to be 
truncated beyond that point (see Section 4.9.3 of the ANSI C 
Standard). However, some of the modes truncate the file upon open. 
The following table lists whether a file is truncated after a write. 


File 

Mode Truncated? Comments 


"r" or "ra" N/A 

"w" or "wa" No 

"a" or "aa" No 

"r+" or "rat" No 

"w+" or "wa+" No 

"a + " or "aa+" No 

"rb" N/A 

"wb" No 

"ab" No 

"rb+" No 


No writes allowed. 

The file is truncated at open 
time only. 

All data are written after EOF. 

All data are written after EOF. 
No writes allowed. 

The file is truncated at open 
time only. 

All data are written after EOF. 
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"wb+" No 

"ab+" No All data are written after EOF. 


□ A call to the fopen function opens a buffered I/O stream. For writes, 
data are stored into the buffer until it is full, and then the data are 
written out. A call to the f flush function forces a write of any 
buffered data. 

You can use the library routines setbuf and setvbuf to change 
between buffered, unbuffered, and line buffered modes. For more 
information, refer to the description of these functions in the SAS/C 
Development System Library Reference. 

□ A zero-length file can be created by either creating a file and not 
writing anything to it or by truncating an existing file. 

□ In general, a file can be opened multiple times as long as a previous 
call to open the file did not physically create the file. However, some 
devices or file-handlers may prevent multiple opens. Refer to the 
documentation for the device or file-handler that you are using. 

□ A file cannot be deleted if there are any outstanding locks or file 
handles on the file. In this case, the remove function sets err no and 
—OSERR and returns a nonzero value. 

□ The output for %p conversion specification for the fprintf function 
is the pointer’s value in hexadecimal. 

□ The input for the %p conversion specification for the f scanf function 
is a hexadecimal pointer, optionally preceded by Ox or OX. 

□ A minus (— ) character that is neither the first nor the last character in 
the scanlist for a %[ conversion specification in the f scanf function is 
treated as a subrange specifier. That is, % [ a-d] is equivalent to 
%[abcd). 

□ The functions fgetpos and ftell set the variable errno to the 
value of EBADF for a bad file handle. Otherwise, errno is set as 
described in the SAS/C Development System Library Reference for the 
function lseek. 

□ The per r or function generates the following messages: 


Value Description 

0 

EPERM 


ENOENT 


Unknown error code 
User is not owner 
No such file or directory 
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ESRCH 

EINTR 

EIO 

ENXIO 

E2BIG 

ENOEXEC 

EBADF 

ECHILD 

EAGAIN 

ENOMEM 

EACCES 

EFAULT 

ENOTBLK 

EBUSY 

EEXXST 

EXDEV 

ENODEV 

ENOTDIR 

EISDIR 

EINVAL 

ENFILE 

EMFILE 

ENOTTY 

ETXTBSY 

EFBIG 

ENOSPC 

ESPIPE 

EROFS 

EMLINK 


No such process 
Interrupted system call 
I/O error 

No such device or address 

Arg list is too long 

Exec format error 

Bad file number 

No child process 

No more processes allowed 

No memory available 

Access denied 

Bad address 

Bulk device required 

Resource is busy 

File already exists 

Cross-device link 

No such device 

Not a directory 

Is a directory 

Invalid argument 

No more files (units) allowed 

No more files (units) allowed for this 

Not a terminal 

Text file is busy 

File is too large 

No space left 

Seek issued to pipe 

Read-only file system 

Too many links 
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epipe Broken pipe 

EDOM Math function argument error 

erange Math function result is out of range 


□ If the functions calloc, malloc, or realloc are passed a size of 
zero, the allocation fails, and the function returns a NULL pointer, 
errno is set to the value of EINVAL. 

□ The abort function closes all open and temporary level 2 I/O files. 

□ The value passed to the exit function is the value that is passed back 
to the system. For EXIT-SUCCESS, the value returned is 0. For 
EXIT-FAILURE, the value returned is 20. 

□ The list of environment names are in the system file-handler ENV : . 
Environment name values are modified through the putenv function. 

□ The contents and mode of execution of the string passed to the 
AmigaDOS system by the system function is as follows: 

□ Under AmigaDOS Version 1.3, the AmigaDOS function Execute is 
called. 

□ Under AmigaDOS Version 2.0 or higher, the AmigaDOS function 
System is called. 

The system function returns the value returned from the AmigaDOS 
Execute or System function. If the command processor cannot be 
invoked, system returns a -1. 

□ The strerror function returns the same error messages as the 
perror function. The messages returned by the perror function are 
listed above. 

□ The default time zone is CST6, and the default for Daylight Savings 
Time is 0. 

□ The era for the clock function is based on the first call to the clock 
function. The first call returns a value of zero, and subsequent calls 
measure the processor time from that starting point. For more 
information, refer to the description of the clock function in the 
SAS/C Development System Library Reference. 

F.3.15 Locale- n The execution character set contains all ASCII characters in all locales. 

^ Specific Behavior □ The direction of printing is from left to right. 

□ The period (.) is the decimal-point character. 

□ Refer to the description of the is functions in the SAS/C 

Development System Library Reference for information on the 
implementation-defined aspects of character-testing and case-mapping 
functions. 
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r.5.3.3 New 


r.7.1.6 Type 
Specifiers 

r.7.3 Asm 
Declarations 


r.7.4 Linkage 
Specifications 


□ The collation sequence for ASCII characters is used as the collation 
sequence of the execution character set. 

□ The SAS/C Development System uses the normal U.S. time and date 
conventions for the C locale. 


Type Values 


Weekday name 


Sun Mon Tue Wed Thu 


Fri 


Sat 


Month name 


Jan Feb Mar Apr May Jun 
Jul Aug Sep Oct Nov Dec 


Date/Time 

format 


DDD MMM dd hh:ram:ss YYYY 
Tue Jun 16 14: 12:22 1992 


C+ + Language 

The following sections describe the SAS/C C+ + translator behavior for 
those areas described as implementation dependent in the Reference 
Manual section of The C++ Programming Language, Second Edition. This 
information is organized like that Reference Manual section. 

operator new is responsible for memory allocation; it does not leave 
the allocation up to the constructor. 

The effect of modifying a const object through a non-const pointer is 
unpredictable and could cause a system crash. 

An asm declaration (for example, asm( str_lit ) ) is ignored by the 
translator. Do not confuse the use of an a sm declaration with the SAS/C 
asm keyword. 

There are only two accepted linkage strings, "C" and "C++". For 
functions, "C" linkage means that type information is not encoded in the 
function’s identifier and that the parameter-passing mechanism is decided 
by the parameters option. For items other than functions, "C" linkage 
does not affect the linkage. The linkage for main is always "C". 
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r.9.2 Class Non-static data members are allocated in the order in which they are 
Members declared. 


r.10.1 Multiple Base classes are allocated in the order in which they are specified in the 
Base Classes derived class. 


r.16.4 File There is no nesting limit for ^include statements. 

Inclusion 

r.16.5 Conditional There is no nesting limit for conditional compilation. 

Compilation 
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Appendix 4 

Converting From Aztec C to 
the SAS/C Development 
System 

343 Introduction 

343 Using the Conversion Utilities 

344 Converting Compiler Options 
348 Converting Linker Options 


Introduction 

This appendix describes four utilities that help you convert from Aztec C 
to the SAS/C Development System and contains tables that list each of the 
Version 5 Aztec C compiler and linker options and their equivalent 
Version 6 SAS/C options. 


Using the Conversion Utilities 

The SAS/C Development System provides four utilities to help you 
convert from Aztec C to the SAS/C Development System: 

cctosc [>scoptions] cc-options 

converts Aztec C compiler options to SAS/C compiler options. If you 
specify an Aztec option for which there is no equivalent SAS/C option, 
cctosc displays a message and may suggest alternatives. 

You can specify >scoptions to redirect the output of cctosc to 
an scoptions file in the current directory. The scoptions file is 
similar to the Aztec C ccopts environment variable, but you can 
have an scoptions in each directory, 
lntoslink [>scoptions] In-options 

converts Aztec C linker options to SAS/C linker options. If you specify 
an Aztec option for which there is no equivalent SAS/C option, 
lntoslink displays a message and may suggest alternatives, 
mcc [cc-options] [sc-options] filename [filename]... 

accepts cc options and runs the SAS/C compiler, mcc is an Aztec C 
compatible driver for sc. You can specify Aztec C and SAS/C options. 
If you specify an Aztec option for which there is no equivalent SAS/C 
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option, mcc displays an appropriate message and may suggest 
alternatives. 

min [In-options] [slink-options] filename [filename]... 

accepts In options and runs the SAS/C linker, min is an Aztec C 
compatible driver for slink. You can specify Aztec C and SAS/C 
options. If you specify an Aztec option for which there is no equivalent 
SAS/C option, min displays an appropriate message and may suggest 
alternatives. 

Note: Whenever possible, use the link option to the sc command to 
link your programs. Use the slink command to link only if you are 
limited by the s c command. For the majority of programs, linking with 
the sc command is much simpler and easier than linking with the 
slink command. If you link using the sc command, you can specify 
many linker options directly and others with the linkeropt compiler 
option. For more information, refer to the descriptions of compiler 
options in Chapter 8, “Compiling and Linking Your Program.” 


Converting Compiler Options 

Table A4.1 lists each of the Aztec 5.0 compiler options and their 
equivalent s c options (if available). Some Aztec C options do not have 
equivalent SAS/C options. Also, for some SAS/C options listed in this 
table, you must specify additional options before the ones listed in this 
table will take effect. For example, you must specify the genprotos 
option before the genprotoparras option will take effect. 


Table^&l^Convening^ztec^Comjrile^^ 

Aztec C 

Option SAS/C Option Comments 

-3 no equivalent 


-5 no equivalent 

-a disasm = filename 

-at disasm=filename 

debug=line 
-bd stackcheck 


This option generates assembly output. 

The debug option adds C source to the 
assembly output. 

stackcheck is the default setting. You can 
turn off stack checking with nostackcheck. 

( continued ) 
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Aztec C 

Option SAS/C Option Comments 

-bs debug= level You can specify one of five levels of debug 

information. 


cpu=68020 

define symbol=value 

math=ieee 

math=f fp 

math= standard 


math = 68 8 8 1 

qst=gst-filename 
mak e g s t =gst-fi lename 
includedi rectory = filename 
no equivalent 

no equivalent 
code=f ar 


You must also link with the appropriate math 
library. 

You must also link with the appropriate math 
library. 

You must also link with the appropriate math 
library. 

You must also link with the appropriate math 
library. 


This option is on by default. 


-md data=far 

-me no equivalent 

-mm strsect=code 

-ms strsect=def ault 

-o oh jectname* filename 

-pa ansi 


(continued) 
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TableA4^^continued) 


Aztec C 
Option 

SAS/C Option 

Comments 


-pb 


Bitfields are unsigned by default. Use the 
signed keyword to declare a signed bitfield. 


-pc 

ignore** 132 

This option suppresses the warning for tokens 
after flendif. 


-pe 

no equivalent 



-pi 

noshortint 



-po 

oldpp 



-PP 

unsignedchar 



-ps 

shortintegers 



-pt 

trigraph 



-pu 

no equivalent 



-qa 

genprotoparms 



-qf 

errorrexx 



-qp 

nogenprotostatics 



-qq 

noverbose 

noversion 



-qs 

nogenprotoexterns 



-qv 

no equivalent 



-r4 

data=f aronly 

This option uses register A4 for register 

variables. Do not use the near keyword if 

you use this option. 


-sa 


This option is always on. 


-sb 

no equivalent 

Include string . h in your source code. 


-sf 

optimize 



-sm 

no equivalent 

Include the appropriate header file in your 
source code. 

/-■V 

-sn 


This option is always on. 




( continued ) 
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Table^4^Jcontinued^ 


Aztec C 
Option 

SAS/C Option 

Comments 

-so 

optimize 


-sp 


The cleanup overhead reduction enhancement is 
always on unless you specify debug=sf or 
debug=f f . 

-sr 

optimize 


-ss 

str ingmerge 


-su 


This option is the default setting. You can 
disable this option with thenoautoreg option. 

-wa 


This option is the default setting. You can 
disable this option with the ignore = 88 option. 

-wd 



-we 

error=all 

This option turns all warnings into errors. To 
make a specific message n an error message, 
specify error =n. 

-wl 


This option is the default setting. 

-wn 

ignore=225 


-wo 


This option is the default setting. 

-wp 


This option is the default setting. You can 
disable this option with the ignore=100 
option. 

-wq 

no equivalent 

Use command line redirection. 

-wr 


This option is the default setting. You can 
disable this option with the 
nowarnvoidreturn or ignore = 85 option. 

-ws 

ignore=all 

This option turns off all warnings. 

-wu 


This option is the default setting. You can 
disable this option with the ignor e = 9 3 option. 

-ww 

maxerr-n 

The number n specifies the new error limit. 
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Converting Linker Options 

Table A4.2 lists each of the Aztec 5.0 linker options and their equivalent 
slink options (if available). Some Aztec C options do not have 
equivalent SAS/C options. 


TabIe^4J2_Converting^zteC-£JAnk^^ 

Aztec C 

Option SAS/C Option Comments 


+a no equivalent 


+c[c | b | d] no equivalent 
+f [c | b | d] no equivalent 
-f filename with filename 

-g addsym 

-1 library 


Modules are always aligned on longword boundaries. 
Functions within a module are aligned on word 
boundaries. To force a function to be aligned on a 
longword boundary, declare the function with the 
aligned keyword. 

Use the chip keyword, or the codemem=chip, 

datamem=chip, or bssraem=chip compiler options. 

Use the far keyword, or the codemera=f ast, 

dataraera=f ast, or bssmem=fast compiler options, 
slink does not place any restrictions on the contents 
of the with file. If you link your program by specifying 
the link option in the sc command, you can use the 
linkerwith compiler option to specify a with file, 
slink does not create a separate file for debugging 
information. The debugging information is embedded in 
HUNK—DEBUG hunks within your executable module. 

You do not need to specify library a second time to 
turn off this option, slink ends the library option 
when it encounters a different option or the end of the 
command line. 


(continued) 
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3aWe^4j2Jcontinued^^__^_ 
Aztec C 

Option SAS/C Option 

+1 filename library filename 
-m no equivalent 


-o filename to filename 


+o[i] no equivalent 


-q stripdebug 

+q quiet 

+s smallcode 

-ss maxhunk 8192 

-sss no equivalent 

-t map s 


-w no equivalent 


Comments 


slink does not produce warnings when 
symbols in the object module override symbols 
in the library. 

If you do not use the to option and you specify 
one filename on the slink command line, 
slink will use that filename (without the file 
extension) as the object module name. If you 
specify more than one filename, slink assumes 
that the first filename is the name of a startup 
module and will use the second filename as the 
object filename. 

slink handles overlays differently than In. See 
the description of overlays in Chapter 8, 
“Compiling and Linking Your Program,” for 
more information. 


slink provides many additional map options. 
See the description of linker options in Chapter 
8, “Compiling and Linking Your Program,” for 
more information. 

The debug information generated by sc is 
compatible only with the CodeProbe debugger. 


'erbose 
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Appendix 5 

Converting from Version 5 
to Version 6 

351 Introduction 

351 Upgrading from Previous Versions 

352 Converting Compiler Options 
360 Specifying Version 6 Libraries 


Introduction 

This appendix provides guidelines for converting your projects to SAS/C 
Version 6. This appendix also lists each of the Version 5.10 options and 
libraries and their equivalent Version 6 options and libraries. 


Upgrading from Previous Versions 

You should install Version 6 in a separate location from previous 
versions of the compiler. Modify your startup sequence files to either 
remove the LC : directory from your path or ensure that the directory 
SC : C is on your search path before LC : . 

In addition, make sure that include: and lib: get assigned to the 
correct include and link library directories for Version 6. The compiler 
for Version 6 does not use the QUAD : device used by previous versions. 

In general, it is a good idea to recompile all your code when you 
convert to Version 6. However, because the Version 6 libraries are ANSI- 
compliant, your old programs may not compile or may generate many 
warning messages. Appendix 1, “Solving Common Problems,” provides 
solutions to some of the problems you may encounter in converting to 
Version 6. 

You may want to use the sc 5 command to convert older, seldom-used 
projects. The sc5 command accepts Version 5 options and reads default 
options from the file sascopts. However, it is recommended that you 
become familiar with and begin using Version 6 as soon as possible. 

You can use the lctosc conversion utility to convert your Version 5 
sascopts file to a Version 6 scoptions file and to determine quickly 
the Version 6 equivalent of a Version 5 option. The lctosc utility reads 
the sascopts file in the current directory, reads any command-line 



options, converts the options to Version 6 options, and writes the results 
to standard output. For example, to convert the sascopts file in the 
current directory to a Version 6 scoptions file, enter the following 
command at the Shell prompt: 

lctosc >scoptions 

To determine the Version 6 equivalent of the Version 5 option -cs, enter 
the following command: 

lctosc -cs 

For code compiled with previous versions of the compiler, the new 
version of CodeProbe can read the line number information but cannot 
read the symbol information from the executables. Recompile your code 
with the Version 6 compiler to produce usable debugging information for 
symbols. 

If you get unresolved symbols when you link your application, you may 
be referring to symbols whose names have changed so as to make the 
compiler conform to the ANSI Standard. In this case, look up the symbol 
name in the SAS/C Development System Library Reference to determine 
the new name, and change any references to the symbol name in your 
code to the new name. Alternatively, you can choose to use the define 
linker option to force all references to the old name to refer instead to 
the new name. 


Converting Compiler Options 

Table A5.1 lists each of the Version 5 options and the equivalent 
Version 6 option (if available). Some Version 5 options do not have 
equivalent Version 6 options. Also, for some Version 6 options listed in 
this table, you must specify additional options before the ones listed in 
this table will take effect. For example, you must specify the link option 
before any of the math=£ype options will take effect, and you must 
specify the genprotos option before the genprotoparms option will 
take effect. 
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TabIe^5^£onvertingJ/enior^j)£j}tion!^^ 


Version 5 
Option 

Version 6 Option 

Description 

- + 

verbose 

Display commands as executed 

-■ 

noversion 

Suppress execution message 

-ab 

bss=chip 

Force all uninitialized data (BSS) to chip memory 

-ac 

code=chip 

Force all code to chip memory 

-ad 

data=chip 

Force all initialized data to chip memory 

-b 

data=near 

Base relative data (16-bit offsets) 

-bO 

data=f ar 

Non-base relative data (32-bit offsets) 

-b 1 

data=near 

Base relative data (same as -b) 

-ba 

data=auto 

Automatic non-base relative on data overflow 

— c+ 

idlen= 100 

Allow longer identifiers for C+ + 

-ca 

ansi 

Maximize ANSI compatibility 

-cc 

commentnest 

Allow nested comments 

-cd 

ignore=77 

Allow $ in identifiers 

-ce 

noerror source 

Suppress source line printing for errors 

-cf 


Require function prototypes 1 

-ci 

nomultiple includes 

Suppress multiple includes of same file 

-ck 

ansi 

Suppress non-ANSI keywords (chip, far, near) 

-cl 

Use aligned keyword. 2 

Align all externs on longword boundary 

-cm 

multiplechar const ants 

Allow multiple character constants 

-CO 

oldpp 

Enable old style preprocessor 

-cp 


Allow # i f to span files 

-cq 

structequi valence 

Allow passing of equivalent structure silently 

(continued) 


‘Version 5 did not require function prototypes. By default. Version 6 requires function prototypes. To suppress the Version 
6 

messages dealing with prototypes, specify ignore=100 + 161 + 15<i. 

2 Use the aligned keyword to force individual objects to longword boundaries. 
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Table A5.1 (continued) 

Version 5 

Option Version 6 Option 




-C 

-d 


-dO 
-d 1 


-d2 


-d3 


stringmerge 

unsignedchar 
nowarnvoidreturn 
noexternaldef s 
oner r or = continue 
debug=line 
nodebug 
debug=line 
debug=symbol 
debugs symbol flush 


-d4 debug=full 

-d5 debug=fullf lush 


-dsym=val define sym=val 
-E errorrexx 

-EfUename 


-eO 


-el 


-e2 


-f 8 


math=f fp 
math=68 8 8 1 


Description 

Disallow asm keyword on function definitions 

Create only one copy of identical strings 

Obsolete - does nothing 

Force all char declarations to unsigned char 

Shut off warning for return without a value 

Treat all global declarations as externs 

Continue on error 

Enable debugging 

Disable debugging 

Enable debugging - dump line table 

Generate symbol information 

Generate symbol information and flush registers 
at every line 

Generate full symbol information 

Generate full symbol information and flush 
registers at line 

Define preprocessor symbol to a value 
Invoke Editor on error 

Invoke Editor on error, filename is an errorfile 
name 

Enable Asian character set (default is Japanese) 
Enable Japanese character set (same as -e) 
Enable Chinese character set 
Enable Korean character set 
Use Motorola FFP (forces -f s) 

Generate code for Motorola 68881 


(continued) 
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Table A5.1 (continued) 

Version 5 
Option 

Version 6 Option 

Description 

-fd 

precision=double 

Use double precision for both float and double 

-ff 

math=f fp 

Use Motorola FFP 

-fi 

math=ieee 

Generate code for IEEE libraries 

-fl 

math=standard 

Use standard SAS/C floating point library 

-fm 

precis ion=mixed 

Use single precision for float, double for double 

-fs 


Use single precision for both float and double 

-gc 

xref system 

Cross-reference compiler-provided files 

-gd 

xrefmacros 

Cross-reference defined symbols 

-ge 


List excluded lines 

-gh 

listheaders 

List header files 

-gi 

listsystem 

List included files 

-gm 

listmacros 

List macro expansions 

-gn 

listnarrow 

Print narrow lines 

-go 

errorlisting 

errorconsole 

Put errors and warnings to both stderr and 
listing file 

-gs 

list 

List source 

-gx 

xref erence 

Produce cross reference listing 

-g= filename 

listf il e= filename 

Generate listing file with name filename 

-Hna me 

gst =gst-filename 

Read in precompiled header file name 

-hb 

bss=f ast 

Force all uninitialized data (BSS) to fast RAM 

-he 

code=f ast 

Force all code to fast RAM 

-hd 

data=f ast 

Force all initialized data to fast RAM 

-ix 

incdirectory=fiiename 

Specify directory to search for includes 

-jn 

ignor e=n 

Disable message number n 


( continued ) 
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TabIe^A5^Jcontinued^^^^^^^^ 
Version 5 

Option Version 6 Option 

-jne error=n 

-j*e error=all 

-jni ignore=n 

-j*i ignore=all 

-jnw warn =n 

-ja noerrorhighlight 

-L+ ob j ect=ob/ec(-/i/e 

libr ary =link-library 
-La addsym 

-Lc sraallcode 

-Ld sma 1 ldata 

-Lf math=f f p 

-Lh maphunk 

-Li nostdio 

-LI maplib 

-Lm math=math-type 

-Ln stripdebug 

-Lo mapoverlay 

-Ls mapsym 

-Lt smallcode 

smalldata 
verbose 
-Lv verbose 


Description 

Make message number n an error instead of a 
warning 

Turn all warnings into errors 
Disable message number n (same as - jn) 

Disable all warnings 

Enable message number n as a warning 

Suppress ANSI escape codes from error line 

output 

Specify additional linker objects 

Add symbol information when linking 
Use small code memory model (16-bit jumps) 

Use small data memory model (16-bit data offsets) 
Link with FFP math library 
Produce linker hunk map 

Link with tlnymain instead of main. 

(With Version 6.50, this option has no effect.) 

Produce linker library map 

Link with appropriate math library 

Suppress debugging information in executables 

Produce linker overlay map 

Produce linker symbol map 

Use typical link options (same as -Lc, -Ld, -Lv, 

or -Lcdv) 

Print verbose linking information 


( continued ) 
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Table A5.1 (continued) 


Version 5 
Option 

Version 6 Option 

Description 

-Lx 

mapxref 

Produce linker cross-reference 

-1 

Use aligned keyword. 1 

Align objects on longword boundaries 

-M 

modified 

Compile only modified source files 

-in 

cpu=any 

Generate code for Motorola 68000 

-mO 

cpu=68000 

Generate code for Motorola 68000 (same as -m) 

-ml 

cpu=68 0 1 0 

Generate code for Motorola 68010 

-m2 

cpu=68 020 

Generate code for Motorola 68020 

-m3 

cpu=68030 

Generate code for Motorola 68030 

-ma 

cpu=any 

Generate code for all Motorola processors (same 
as -m) 

-me 


Disable cleanup overhead reduction enhancement 

-ml 

libcode 

Generate code for resident library use 

-mp 

absfunepo inter 

Generate 32-bit references to functions 

-mr 

noautoregister 

Disable automatic registerization 

-ms 

optsize 

optimize 

Generate code optimized for space 

-mt 

opttime 

optimize 

Generate code optimized for time 

-N 


Disable linking from editor 

-n 

identif ier length=8 

Retain only 8 characters for identifiers 

-nn 

identif ierlength=n 

Specify maximum length for identifiers 

-0 

optimize 

Invoke global optimizer 

-ox 

ob j ectname=fi/ename 

Place object file in filename 

-Px 

prograraname “filename 

Use filename as the name of the final executable 
module (continued) 


'Use the aligned keyword to force individual objects to longword boundaries. 
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Tabje^5^Jcontinued^^^^^^^^^ 
Version 5 

Option Version 6 Option 

-p preprocessonly 

-pe nogenprotostatics 

-ph makegst =filename 

-pi 

-pp genprotoparms 

-pr genproto 


-ps nogenprotoexterns 

nogenprotodatai terns 
-pt nogenprototypedef s 


-qx 

-qne 

-qnw 


-q 


-rO 


-r 1 


-rb 


maxerr=n 
maxwarn =n 
maximumwarn = 1 
maximumerrors= 1 
code=near 
code=f ar 
code=near 
parms=register 
parms=stack 
parms=both 


-'Rfilename objectlib=/iZename 


Description 
Preprocess only 

Generate prototypes for external functions 

Generate precompiled header file 

Include identifier names in generated prototypes 

Generate prototypes with parms for 

portability 

Generate prototypes for external and static 
functions 

Generate prototypes for static functions only 

Suppress use of typedefs when generating 
prototypes 

Place quad file in location x 

Quit compilation after n error/warnings 

Quit compilation after n warnings 

Quit after 1 error or 1 warning (same as 
-qlelw) 

Default function calls to near (PC-relative) 

Default function calls to far (Absolute) 

Default function calls to near (Same as -r) 

Pass and receive parameters in registers 
Pass and receive parameters on the stack 

Generate code for both register and stack 
conventions 

Place compiled objects into library filename 

( continued ) 
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Table A5.1 < continued ) 


Version 5 
Option 

Version 6 Option 

Description 

" s 


Use default segment names text, data, and 
udata 

-sb=name 

bssname=name 

Specify a name for uninitialized data (BSS) 
segment 

-sc=name 

codename =name 

Specify a name for code segment 

-sd =name 

dataname=name 

Specify a name for data segment 

-t 

startup=cback 

Link with cback . o instead of c . o 

-tb 

startup=cback 

Link with cback . o instead of c . o (same as -t) 

-tc 

startup=catch 

Link with catch . o instead of c . o 

-ter 

startup=catchres 

Link with catchres . o instead of c . o 

-tr 

startup=cres 

Link with cres . o instead of c . o 

— t — X 

s t a r tup = filename 

Link with filename instead of c . o 

-U 


Undefine all preprocessor symbols 

-V 

nostackcheck 

Disable stack checking code 

-W 

shortintegers 

Default to short integers 

- x 

noexternaldef s 

Treat all global declarations as externals (same as 

-y 

saveds 

Load A4 with base address at start 

-z nnn 

ppbuf =nnn 

Set preprocessor expansion buffer size to nnn 
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Table A5.2 
Specifying Version 6 
Libraries 


Specifying Version 6 Libraries 

Table A5.2 lists each of the Version 5 libraries and the equivalent 
Version 6 library. In Version 6, the standard libraries provide support 
for registerized parameters. To use registerized parameters, you must 
compile with the parras = registers option, but you do not need a 
special library. 


Version 5 Library' 
lc.lib 
lcm. lib 
lcmieee .lib 
lcmf fp. lib 

lcmr . lib 

lcms . lib 
lcmsr .lib 
lcra88 1 . lib 
lcmr88 1 . lib 
lcnb. lib 

lcr . lib 

lcs . lib 
lcsnb. lib 
lcsr . lib 


Version 6 Library 
sc .lib 
scm. lib 
scmieee . lib 
scmf fp. lib 
scm. lib 
scms .lib 
scms .lib 
s cm8 81 .lib 
scm88 1 . lib 
scnb. lib 
sc . lib 
scs .lib 
scsnb. lib 
scs . lib 
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A 

.a filename extension 84 
abbreviated menus 54 
Abort button 4 
abort function 339 

absfuncpointer compiler option 93, 194 

accelerator keys 54 

addresses 

chip data 193-194 

modifying access to program code and data 194 
reentrant and non-reentrant programs 193 
addresses for SAS Institute Technical Support 33-34 
addsym linker option 133 
addsymbols compiler option 93 
AddTask function 123 

aligned keyword 171-172 

automatic variable problems 1 72 
definition 170 

effect on definitions of functions 171 
ensuring stack alignment 172 
SAS/C compiler behavior 333 
Alt keys 
equivalence 64 
independent operation 64 
Alt-Y key 45 

American National Standards Institute 
See ANSI Standard for C 
Amiga keys 

redefining (caution) 64 
AmigaGuide help system 31-32, 75 
amigaguide.se 75 
angle brackets (< >) 
enclosing strings 334 
specifying # include statement 10, 334 
ansi compiler option 93-94 
enabling suppressed messages 224, 327 
purpose and use 93-94 
using national characters in variables 185 
warning messages for C+ + style comments 184 
writing portable code 199 
ANSI Standard for C 
See also implementation-defined behavior 
See also portable code, writing 
See also SAS/C extensions to C and C+ + languages 
conformance of C++ preprocessor 189 
default argument promotion rules 205 


format for incoming command line 155 
portability considerations 200 
ANSI-compliant C compilers 200 
AREXX interface 71-79 
AREXX port 74-75 
command summary 76-79 
commands without keystroke equivalents 79 
communicating with external programs 74-75 
definition 71 

executing a series of editor commands 71-74 
keystroke equivalents for commands 76-79 
separating commands with spaces 71 
stringing together multiple commands 71 
AREXX macros 
amigaguide.se 75 
assigning to keys 72 
definition 71 
deletetabs.se 75 
examples 72-74, 75 
findsym.se 75-76 
indent.se 76 

macros provided with the compiler 75-76 
naming 72 

newline character (\n) 72 
.se suffix required 71 
tolower.se 76 
toupper.se 76 
unindent.se 76 
argc and argv 

ANSI Standard requirement 155 
Shell environment 147-148 
Workbench environment 148 
arguments 

raising argument limits 155 
argumentsize= compiler option 94 
See also memorysize = compiler option 

SAS/C Compiler behavior 333 
ASCII characters 
collation sequence 340 
SAS/C Compiler behavior 331, 332 
asctime function 218-219 
asm declaration, C+ + 340 
.asm filename extension 84 

asm keyword 

affecting caller and callee 171 
changing parameter-passing methods 173 
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asm keyword ( continued ) 

definition 170 

relationship with parameters = option 121 
Asm modes 66-67 
assembler = compiler option 84, 94 
assert function diagnostic 335 
assignment statements 

added to startup file by installation program 4 
adding to startup file 5, 213 
assigning to correct version of SAS/C Development 
System 1 1 
asterisk (*) 

Asm mode 66 

indicating depth of overlay tree 141 
indirection operator 171 
marked block indicator [*] 44, 47 
at sign (@) 

preceding linker symbols 134, 174 
AUTO keyword 150 

Auto-Indent Mode, Options pull-down menu 67 
auto-indent stops, setting 65 
autoinitialization function 160-163 
changes and enhancements xxvii 
definition 160 
example 162 

library bases automatically initialized 164-165 
order of execution xxxi, 162-163 
priorities 161 

source code for standard I/O routine 151 
_STI preceding function name 161 
using level 1 or 2 I/O functions 163 

ctors array 162, 163 

automatic storage class 197 
automatic variables 
stack alignment problems 172 

autoopenfail function 166-167 

autoregister compiler option 95, 197, 333 
autotermination function 160-163 
changes and enhancements xxvii 
definition 160 
example 162 

order of execution xxxi, 162-163 
priorities 161 

_STD preceding function name 161 
using level 1 or 2 I/O functions 163 

dtors array 162, 163 

Auto wrap option 67 
avail command (AmigaDOS) 21, 26 
Aztec C, converting to SAS/C 343-349 
compiler options 344-347 


conversion utilities xxxii, 343-344 
linker options 348-349 


B 


BACKDROP keyword 150 
— BackGroundIO external definition 157 
backslash (\) 

preceding comment character in Asm mode 67 
\ (backslash) 

See backslash (\) 

Backspace key 45 
Backstdoul external definition 
AmigaDOS functions requirements 157-158 
definition 157 
NULL file handle 158 
printing messages in the Shell 158 
Backup File Mode option. Options pull-down menu 
backward searching 46 
base classes, C+ + 341 
batch compiler option 95 
batch linker option 133 
Beginning option, Block pull-down menu 55, 57 
bitfields xxviii, 333 
bitwise operations 331-332 
BIX (Byte Information Exchange) 34 
block operations 47-48 
indenting with indent macro 76 
keys and options 57 
marked block indicator 44 
marking blocks 47 
unindenting with indent macro 76 
unmarking blocks 48 
Block pull-down menu 
Beginning 55, 57 
Copy 57 
Delete 56, 57 
End 55, 57 
Move 57 
Print 57 
Read 48, 57 
Write 57 
braces ({ }) 

Auto-Indent Mode 67 
bssmemory “ compiler option 95, 194 
bssname— compiler option 95, 190 
bufsize linker option 133 
Build icon 

compiling and linking programs 19-20 
compiling programs 85 


67-68 
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compiling programs with default options 17 
purpose 6, 14 

buildproject compiler option 85, 95-96 
Byte Information Exchange (BIX) 34 



c directory 6 
.c filename extension 84 
c.o startup module 
default module 156 
definition 1 54 


C+ + It 

See also SAS/C extensions to C and C+ + languages 

asm declaration 340 

class members 341 

comment blocks 184 

complex library xxix 

conditional compilation 341 

file inclusion 341 

implementation-defined behavior 330 
linkage specifications 340 
multiple base classes 341 
new operator 340 

^ SAS/C compiler behavior 340-341 
streams library xxix 
type specifiers 340 
unavailable for floppy-disk systems 9 
C+ + programs, translating 187-189 
changes and enhancements xxix 
demangle utility xxix 

expanded translation process, illustration 188 
preprocessing 188 
translator messages 283-319 
C+ + programs, writing 
See source files, creating 
C+ + translator messages 283-319 
calloc function 155, 339 
case conversion macros 
tolower.se 76 
toupper.se 76 

Case Insensitive Search, Options pull-down menu 45 
Case Sensitive Characters option, Options pull-down men 
68 

^case-sensitive searches 45 
catch.o startup module 
creating snapshot files 156 
definition 154 


catchnr.o startup module 
definition 154 
snapshot files 156 
catchres.o startup module 
debugging residentable programs 159 
definition 154 

saveds compiler option and — saveds keyword not 
allowed 175 
snapshot files 159 
catchresnr.o startup module 
debugging residentable programs 159 
definition 154 
cback.o startup module 

char * procname external definition 157 

creating detachable programs 157-158 
definition 154 

extern BPTR Backstdout external definition 157 

long BackGroundIO external definition 157 

long priority external definition 157 

long stack external definition 157 

uses 157 

.cc filename extension 84 
cctosc conversion utility xxxii, 343 

char * procname external definition 157 

character constants 115 
character strings 
backward searching 45-47 
case-sensitive searches 45 
entering regular expressions 47 
forward searching 46 

keys and options for searching and replacing 57 
locating with smfind utility 14, xxxi 
menu options for replacing 47, 57 
character strings 
replacing 46-47 
searching for 45-46 
characters 

locale-specific behavior 339-340 
SAS/C Compiler behavior 331 
checkabort compiler option 96 
chip data 

reentrant and non-reentrant programs 193 
chip hunk 190 

chip keyword 172-173 

declaring data items 190, 194 
definition 170 

overriding data -auto compiler option 100 
purpose and use 172-173 
using with residentable programs 158 
chip linker option xxx, 133, 194 
chip memory 9, 14, xxx, 172 



class members, C++ 341 
clock function 339 
close function (AmigaDOS) 157 
Close gadget 20 
CLOSE keyword 150 

Close Window option, Project pull-down menu 51, 58 
code— compiler option 96 
far value 173 

modifying access to program code and data 194 
near value 173 
purpose and use 96 
code hunk 189 
CODE OPTIONS... gadget 18 
codememory = compiler option 96,194 
codename— compiler option 97, 189 
CodeProbe Source Level Debugger 
CodeProbe windows, illustration 22 
completing execution before quitting CodeProbe 22, 27 
cpr.guide help database 31 
debug — symbolflush compiler option required 17 
Dialog window 21-22 
displaying variable values 22 
H-DEBUG hunk 190 
H—SYMBOL hunk 191 
help command 29 
problems with CodeProbe 215 
reading code from previous versions 352 
Shell method of debugging 26-27 
Source window 21-22 
starting with cpr command 26 
starting with Debug icon 21 
stepping through programs 22 
Version 6 changes and enhancements xxvi 
Version 6.50 changes and enhancements xxx 
Workbench method of debugging 21-22 
colon (:) 

Asm mode 66 

contained in name of startup module 155 
colors, changing 58 
Column Display option 
Options pull-down menu 67 
SE Configuration Window 43 
column number, in screen editor (se) 43 
comma (,) 

comma operator in preprocessor directives 184 
separating filenames for sc command 84 
commentnest compiler option 97, 185 
comments 

C++ style comments 184 
comment characters, Asm mode 66, 67 
comment start sequence (/•) 185 


nested comments 185 
slashes (//) defining comment blocks 185 
common compiler option 97, 186 
compiler 

See SAS/C compiler 
compiler options 87-130 
See also compiler options, setting 
abbreviations 87 
absfunepointer 93, 194 
addsymbols 93 

ansi 93-94, 184, 185, 199, 224, 327 
argumentsi7.e= 94 
assembler™ 84, 94 
nutoregister 95, 197, 333 
batch 95 

bssmemory — 95, 194 
bssname— 95, 190 
buildproject 85, 95-96 
case-insensitivity 87, 93 
checkabort 96 
code™ 96, 194 
code = far 173 
codememory™ 96, 194 
codename™ 97, 189 
code -near 173 
commentnest 97, 185 
common 97, 186 
constlibbase 97-98 

converting from Aztec C options 344-347 

converting Version 5 options to Version 6 352-359 

coverage xxvi, 98, 333 

CPU- 98 

csource— 84, 98 

cxxonly 98-99, 188 

cxxsource™ 84, 99 

data- 99-100, 144, 172, 194 

data— auto 100 

data— far 99, 190 

data™faronly 99-100, 190, 333 

datamemory— 100, 194 

datamemory— chip 190 

dataname™ 100-101, 190 

data-near 99, 144, 158, 189 

debug- 101, 190 

debug-full 101 

debug— fullflush 101 

debug— line 101 

debug— symbol 101 

debug— symbolflush 17, 18, 101 

define- 101-102, 212 

disassemble— xxvii, 102 
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dollarok 102, 185 
error = 102 
errorconsole 102 
errorhighlight 103 
errorlist 103 
errorrexx 17, 18, 85, 103 
errorsource 103 
extemaldefs 103 
findsymbol= 103-104, 224 
from 104 

genprotodataitems 104 
genprotoextems 104 
genprotoflle= 104 
genprotoparameters 104 
genprotos 104-105, 214 
genprotostatics 105 
genprototypedefs 105-106 
globalsymboltable= 106 
GSTimmediate 106 
icons 106-107 
identifierlength™ 107 
ignore = 107, 213, 223 
includedirectory= 107 
keepline 107-108 
keyword options 86 
libcode 108, 175 
libfd= 108 
libprefix™ 108 
library = 84, 108 
libre vision = 108-109 
libversion= 109 

link 17, 18, 85, 109, 132, 155, 188, 211 

linkerdefine= 109 

linkeroptions™ 109-110, 132 

linkerwith= 110 

list 110,224 

listfile= 110 

listheaders 110 

listincludes 110-111 

listmacros 111 

listnarrow 111 

listsystem 111 

makeglobalsymboitable = 111 

map 111 
mapfile = 111 

maphunk 112 
maplib 112 
mapovcrlay 112 
mapsymbols 112 
mapxreference 112 
math= 112-113 


math “"coprocessor 332 
math“ffp 113,332 
math — ieee 113 

math “Standard 17, 18, 113, 211 
math =68881 113, 174 
math = 68882 113 
maximumerrors- 113 
maximumwarnings” 113 
memorysize = 114-115 
modified 85, 115 
multiplecharacterconstants 115-116 
multipleincludes 116 
noautoreg 197 
nocheckabort 220 
nostackcheck 218 
object™ 84, 116 
objectlibrary™ 116 
objectname™ 116-117 
oldpreprocessor 117-118 
onerror” 118 
optimize 118, 175 
optimizeralias 118-119 
optimizercomplexity™ 119 
optimizerdepth™ 119 
optimizerglobal 119 
optimizerinline 119 
optimizerinlocal 119 
optimizerloop 120 
optimizerpeephole 120 
optimizerrecurdepth = 120 

optimizerschedule 120-121 
optimizersize 120 
optimizertime 120 
overriding settings in scoptions file 86 
parameters™ 121 

parameters “both 121, 174, 219-220 
parameters “register xxviii, 121, 173-174, 219-220, 
360 

pponly 188, 223, 224 
precision™ 122 

preprocessor symbols defined by compiler options 
131-132 

preprocessorbuffer™ 122 
preprocessoronly 122 
profile xxx, 122 
programname™ 122 
pubscreen™ 123 
resetoptions 86, 123, 214 

SAS/C Compiler Options Index screen, illustration 18 
saveds 123, 158, 174 
shortintegers 123, 195, 196, 201 
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compiler options (continued) 
smallcode 123, 144 
smalldata 124, 144 
solving problems 214 
sourceis™ 124 
specifying 86-87 
specifying in scoptions file 86 
stackcheck 124, 176, 177, 218 
stackextend 124, 176-177, 333 
standardio 124 
startup - 125, 155 

strict 125, 184, 199-200, 201, 224, 327 
stringconst 125 

stringmerge xxvi, 125-126, 144-145 

stringsection - xxx, 126-127, 194, 197 

stringsection = code 127 

stringsection - default 126-127 

stringsection = far 127 

stringsection = near 127 

stripdebug 126 

structureequivalence 127, 181 

summary of options 87-92 

switch options 86 

to— 128 

trigraph 128 

underscore 128 

unschar 334 

unsign edchar 128, 194 

using default options 17, 23 

utilitylibrary 128-130 

verbose 129, 190, 214 

version 129 

Version 5 option equivalencies 353-359 
wam= 129, 201, 224, 327 
wamvoidretum 129 
with= 130 
xreference 130 
xreferenceheaders 130 
xreferencesystem 130 
compiler options, setting 
See also scoptions file 
including on sc command line 25, 86 
saving settings 18, 24 
selecting options from scopts screen 24 
Shell methods 24-25 
using scopts utility 17-18, 24-25 
Workbench method 17-18 
COMPILER OPTIONS... gadget 18 
compiling programs 
See programs, compiling 
computer crashes 218 


CON: keywords 150 
conditional compilation, C++ 341 
configuration file 
See startup file 
Configuration window 
See SE Configuration window 
console window 149 
const keyword 

avoiding linker warnings 194 
solving problems 214-215 
using with residentable programs 158 
const object, C++ 340 
constlibbase compiler option 97-98 
context-sensitive online help 
See help system 

control characters, entering 50 
Control-C 

enabling with checkabort compiler option 96 
turning off control-C checking 220-221 
Control-E key 45 
Control-End key 44 
ControlA escape character 50 
Control-Help key 30 
Control-Home key 44 
Control-Y key 45 
conversion of data types 196 
Convert Macro to Key option. Options pull-down 
converting Aztec C 
See Aztec C, converting to SAS/C 
converting Version 5 
See Version 5, converting to Version 6 
Copy option, Block pull-down menu 57 

coverage compiler option xxvi, 98, 333 
■epp filename extension 84 
cpr command 26 
cpr.guide help database 31 
CPU - compiler option 98 
Create New CLI option, Windows pull-down rneni 
cres.o startup module 
creating residentable programs 158-159 
definition 154 

saveds compiler option and saveds keyword 

allowed 175 

csource- compiler option 84, 98 
— dors array 162, 163 
customizing screen editor (se) 

See SE Configuration Window 

CXBRK function 336 

CXFPE function 336 

— CXOVF stack overflow routine 176 


58 
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.cxx filename extension 84 
cxxinclude directory 7 
cxxinclude: logical device 10 
cxxoniy compiler option 98-99, 188 
cxxsource= compiler option 84, 99 


D 

d (display) command, debugger 22 
-d option, se command 42 
data= compiler option 99-100 
auto value 100 

changing data addressing methods 194 
changing default data section 172 
far value 99, 190 
faronly value 99-100, 190, 333 
near value 99, 144, 158, 189 
purpose and use 99-100 
using in overlays 144 
data file for screen editor (se), specifying 42 
data storage classes 197 
data types and sizes 194-197 
casting results of short integers 196-197 
conversion 196 

effect of shortint option 195, 196 
narrow types in pre-ANSI function declarations 205-206 
pointer length 195 
portability considerations 201 
signed and unsigned objects 194-195 
sizes and values 194-195 
widest operand 195 
datamemory— compiler option 100 
chip value 190 
declaring data items 194 
purpose and use 100 
dataname” compiler option 100-101, 190 
date and time 

locale-specific behavior 339 

DATE preprocessor macro 334 

daylight savings time, default 339 
debug= compiler option 101 
full value 101 
fullflush value 101 
line value 101 
purpose and use 101 
symbol value 101 
symbolllush value 17, 18, 101 
writing debugging information in hunks 190 
Debug icon 
purpose 6, 14 


running CodeProbe 21 
solving problems 215 
debugging programs 
See CodeProbe Source Level Debugger 
declarators 

SAS/C Compiler behavior 334 
def_ prefix for icon names 27 
define= compiler option 101-102 
compared with #define statement 101 
compared with define linker option 102 
purpose and use 101-102 
resolving undefined symbol problems 212 
define linker option 133-134 
forcing symbol name references 352 
purpose and use 133-134 
resolving undefined symbol problems 212 
fdefine statement 

compared with define = option 101 
Delete key 45 

Delete option, Block pull-down menu 56, 57 
deletetabs.se 75 
deleting text 
See screen editor (se) 
demangle utility xxix 
detachable programs 157-158 
Sec also residentable programs 
cback.o startup module 157-158 
creating 157-158 
definition 157 

external definition requirements 157 
restricting to one copy running 158 
devinit.o module 154 
devinitr.o module 154 
diagnostics 

SAS/C Compiler behavior 330 
Dialog window, CodeProbe Source Level Debugger 21-22 
directories 
c 6 

created by installation program 6-8 
cxxinclude 7 

destination for installing SAS/C Development System 4 
env 7 

ENV:sc subdirectory 11 

ENVARCrSC 11 

examples 6 

extras 6 

help 6 

icons 6 

icons for directories 6 
include 7 
Lib 7 



368 Index 


directories (continued) 
libs 7-8 

sc:examples/cback directory 30 
sc:help 31-32 
source 7 
starter_project 6 

disassemble = compiler option xxvii, 102 
diskcopy command (AmigaDOS) 3 
display (d) command, debugger 22 
Display Names option, Project pull-down menu 60 
dollar sign ($) 

allowing as valid characters in identifiers 102 
using in variable names 185 
dollarok compiler option 102, 185 
DOSBase 

required for programs without startup modules 160 
dtors array 162, 163 


E 

Edit icon 6, 14, 42 
See screen editor (se) 

Electronic Mail Interface to Technical Support (EMITS) 
facility xxiii, 34-36 
End (NUM-1) key 44 
End option, Block pull-down menu 55, 57 
enumerated types, specifying size 183-184 
enumerations 

SAS/C Compiler behavior 333 
env directory 7 
ENV: device 1 1 

ENV:sc/scoptions environment variable 11, 86 
ENVrsc subdirectory 1 1 
ENVARC:SC directory 1 1 

SAS/C Compiler behavior 330 
environment names 339 
environment variables 
ENV:sc/scoptions 1 1 
setting 11-12 

stored in ENV: logical device 11 
time zone 218-219 
— EPILOG library function 1 22 
equivalent structures 181-183 
definition 181 
examples 181-183 
error and warning messages 223-328 
C+ + translator messages 283-319 
eliminating informational messages 220 


enabling suppressed messages 327-328 
generated by perror function 337-339 
getting help 224 
linker messages 320-326 
numbered compiler messages 227-282 
suppressing 223 

unnumbered compiler messages 225-226 
using error and warning messages 223-224 
error-related compiler options 
error = 102 
errorconsole 102 
errorhighlight 103 
errorlist 103 
errorrexx 17, 18, 85, 103 
errorsource 103 

onerror = 118 

errors in source file, correcting 19-20, 25-26 
escape character (ControlA) 50 
examples directory 6 
executable module 189 
execute command 
including in startup file 5 
exit function 339 

Exit SE option, Project pull-down menu 51, 60 
extern BPTR — Backstdout external definition 157 
external data 

relaxed ref-def xxvi, 185-186 
strict ref-def 185-186 
external definitions 

required for detachable programs 157-158 
external programs 

communicating with AREXX interface 74-75 
external storage class 197 
external symbol information in hunks 189 
extemaldefs compiler option 103 
extras directory 6 


F 

fancy linker option 134 
far BSS hunk 190 
far data 190 
far data hunk 190 
— far keyword 172-173 
affecting only calling function 171 
compatibility with previous releases 173 
declaring data items 194 
declaring far data 190 
definition 170 



Index 369 


overriding data=auto compiler option 100 
purpose and use 172-173 
using with residentable programs 158 
far value, data= compiler option 99, 190 
faronly value, data= compiler option 99-100, 190, 333 
fast linker option 134, 194 
faster linker option 134 

' r ~*' 5 ax numbers for SAS Institute Technical Support 33-34 
■flush function 337 
fgetpos function 337 
file inclusion, C+ + 341 
File option. Project pull-down menu 48 
filename extensions 

options for specifying with sc command 84 
recognized by sc command 84 
files 

See also screen editor (se) 

current filename, in screen editor 44 

editing new files 59 

maximum number of open files 43 

moving around in files 44, 55 

naming 60 

opening more than one 42 
SAS/C compiler behavior 336-337 
saving 50-51, 60 

specifying multiple filenames with sc command 84 
switching between 42, 43 
truncation after a write 336-337 
••ind icon 6, 14 
FindPort function 158 
findsym.se 75-76 

findsymbol= compiler option 103-104, 224 
floating-point math format, specifying 
See math= compiler option 
floating-point numbers 
conversion types 196 
SAS/C Compiler behavior 332 
specifying size with precision = compiler option 122 
value limits 195 

floppy-disk installation of SAS/C Development System 8-9 

fmod function 335 

fonts 

selecting for editor window 66 
System Default font xxx 
fopen function 337 
formal storage class 197 
formatted print functions 
%p conversion 337 
problems 215-216 
forward slash (/) 

See slash {/) 


fpinit function 162 

— fpinit.c function 332 
fprint problems 215-216 
fprintf function 337 
— fpterm function 162 
from compiler option 104 
from linker option 134 
fscanf function 337 
ft ell function 337 
function pointers 171 
functions 

calling in overlays 140 
function call problems 217 
writing replacements for SAS/C library functions 
219-220 

fwidth linker option 134 


G 

g (go) command, debugger 22, 27 
— GENPROTO preprocessor symbol 105 
genprotodataitems compiler option 104 
genprotoexterns compiler option 104 
genprotofile= compiler option 104 
genprotoparameters compiler option 104 
genprotos compiler option 104-105, 214 
genprotostatics compiler option 105 
genprototypedefs compiler option 105-106 
geta4 function 175 
getch function 216 
getchar problems 216 
global default options 86 
global message port 158 
global optimization 
changes and enhancements xxv 
enabling with optimize compiler option 118 
enabling with optimizerglobal compiler option 119 
generating inline code 175 
storage of register variables 197 
global symbol information in hunks 189 
Global Symbol Tables (GSTs) xxv 
globalsymboltable” compiler option 106 
See also makeglobalsymboltable = compiler option 
go (g) command, debugger 22, 27 
go command xxiv 
greater than sign (>) 

indicating long lines in screen editor 45 
grep 

compared with screen editor searching 47 
GST” compiler option 106 
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gst utility xxv 

GSTimmediate compiler option 106 


H 

.h filename extension 84 
H—DEBUG hunk 190 
H-SYMBOL hunk 191 

hard-disk installation of SAS/C Development System 4-8 
directories created by installation program 6-7 
modifying startup file 5-6 
hardware differences 
See portable code, writing 
header files 

AmigaDOS 1.3 files no longer available xxiv 
function call problems 217 
incorrect characters at beginning 214 
multipleincludes compiler option 116 
precompiled files replaced by GSTs xxv 
problems caused by ANSI-compliance 214 
reasons for including incorrect file 217 
specifying system header files 10 
heap area 192 
height linker option 134 
Help button 4 

help command, CodeProbe 29 
help directory 6 
Help key 29, 54 
help system xxiii, 29-32 
See also problem solving 
See also SAS Institute Technical Support 
AmigaGuide system 31-32, 75 
error and warning messages 224 
installation process help 4 
main menu for help information 30 
main menu for help information, illustration 31 
navigating AmigaGuide help databases 32 
sc command 85 
screen editor 52 

screen editor help screen, illustration 30 
Home (NUM-7) key 44 

hunk symbol records 133 

hunks 189-191 

changing hunk names 189, 190, 192-193 
chip hunk 190 
code hunk 189 

contained in primary (root) node 191 
contents 189 

external symbol information 189 
far BSS hunk 190 


far data hunk 190 

H—DEBUG hunk 190 

H-SYMBOL hunk 191 

letters indicating hunks produced by compiler 

near BSS hunk 189 

near data hunk 189 

NTRYHUNK 145, 192 

program code or data contents 189 

relocation records 189 

reserved section names 192-193 

udata hunk 190 

MERGED hunk 189, 192 

NOMERGE hunk 193 

hwidth linker option 135 
hypergst utility xxv 


190 


icons 27-28 

Build 6, 14, 17, 19-20, 85 
created by linker 20 
created by SAS/C tools 28 
Debug 6, 14, 21, 215 
Edit 6, 14, 42 
Find 6, 14 
modifying 28 
naming conventions 27 
preventing creation by tools 28 
preventing specific icon creation 28 
SCoptions 6, 15, 17 
templates in scticons drawer 27 
icons compiler option 106-107 
icons directory 6 

identifierlength= compiler option 107 
identifiers 

SAS/C Compiler behavior 331 
ignore— compiler option 107, 213, 223 
implementation-defined behavior 329-341 
ANSI definition 329 
arrays and pointers 333 
bitfields 333 
characters 331 
declarators 334 
enumerations 333 
environment 330 
floating-point numbers 332 
identifiers 331 
integers 331-332 
library functions 335-339 
locale-specific behavior 339-340 
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preprocessing directives 334 
qualifiers 334 
registers 333 
statements 334 
structures 333 
translation 330 
unions 333 

implicit structure references 180-181 
include directory 7 
# include files 

error and warning messages 224 
search paths 334 
#include statement 

specifying in angle brackets (< >) 10 
include: logical device 10 
includedirectory= compiler option 107 
incomplete structure tags 206-207 
indent linker option 135 
indent.se 76 

indirection operator (') 171 

inline keyword 175 

definition 170 

Input Processing option 66-67 
Asm modes 66-67 
Auto wrap 67 
No processing 66 

Insert File option, Project pull-down menu 56 
Insert key 45 
insert mode 44, 56 

installation of SAS/C Development System 3-12 
assigning logical device names 10-11 
directories created by installation program 6-8 
floppy-disk installation 8-9 
hard-disk installation 4-8 
keeping Version 6.0 and 6.50 8 
making backup copies 3 
modifying startup file 5-6, 213 
omitting parts 4 

Pretend to Install and Log File options 4, 9 
read.me file 5 

registration number requirements 3 
setting environment variables 11-12 
upgrading from previous versions 351-352 
integers 

SAS/C Compiler behavior 331-332 
value limits 1098 
Intel processor 

portability considerations 203 
Interlace Toggle option, Windows pull-down menu 58 
Internet for contacting SAS Institute Technical Support 
34-36 


interrupt keyword 173 

changes and enhancements xxviii 
definition 170 

effect on definitions of functions 171 
purpose and use 173 
IntuiMessage structure 182 
Intuition environment 13 
IOExtSer structure 182 
ioRequest structure 182 
isalnum function 335 
isalpha function 335 
iscntrl function 335 
islower function 335 
isprint function 335 
isupper function 335 


K 

KD command (AREXX) xxx 
keepline compiler option 107-108 
key definitions 63-65 
determining functions of commands 63 
displaying 63-64 
loading with KD command xxx 
qualifiers 64 
raw code 64 
setting 64-65 
keyboard shortcuts 54 

accelerator keys 54 
Alt keys 64 

assigning to AREXX macros 72 
block operations 57 
changing colors 58 
deleting text 45, 56 
editing new files 59 
exiting screen editor 60 
inserting text 56 
managing windows 58 
moving around in files 44, 55 
qualifier keys 63 
saving files 60 

searching for and replacing strings 57 
Shift keys 64 
undoing changes 60 
Keys pull-down menu 
determining functions of commands 63 
purpose and use 62 



keystroke definitions for screen editor 
stored in se.dat file 42 
using default definitions 41 
keystroke equivalents for AREXX commands 76-79 
keystroke macros 49-50 
assigning macros to another key 50 
creating 49 

keys and menu options 59 
keystroke saver active indicator in status line 44 
reloading 49-50 
replaying 49 
saving 49-50 
keyword options 86 
keywords 

affecting caller and callee 171 

affecting definition of functions 171 

affecting only calling function 171 

AUTO 150 

BACKDROP 150 

CLOSE 150 

CON: keywords 150 

const 158, 194, 214-215 

controlling standard I/O window 150 

list of special keywords 170 

NOBORDER 150 

NODRAG 150 

NOSIZE 150 

register 197, 333 

SCREEN 150 

signed 194, 201 

SIMPLE 150 

SMART 150 

specifying in correct places 171 
specifying on function pointers 171 
unsigned 194 
WAIT 150 
WINDOW 150 

aligned 170, 171-172, 333 

asm 121, 170, 171, 173 

— chip 100, 158, 170, 172-173, 190, 194 
— far 100, 158, 170, 171, 172-173, 190, 194 

inline 170, 175 

— interrupt xxviii, 171, 173 
— near 100, 170, 171, 172-173, 189, 194 
— regargs 121, 170, 171, 173-174, 219-220 

saveds 123, 158, 160, 170, 171, 174-175 

stackext 170, 171, 176-177, 333 

— stdargs xxviii, 121, 171, 173-174 


L 

Ictosc conversion utility xxiii, 351-352 

lcl command xxiv 

Ic2 command xxiv 

Lib directory 7 

•lib filename extension 84 

lib: logical device 1 1 

libcode compiler option 108, 175 

libent.o module 154, 159 

libfd™ compiler option 108 

libfd linker option 135 

libinit.o module 154, 159 

libinitr.o module xxxi, 154, 159 

libprefix= compiler option 108 

libprefix linker option 135-136 

libraries 

See also shared libraries 
contained in libs directory 7-8 
problems caused by ANSI-compliant libraries 214 
problems creating resident libraries 219 
symbol name changes between versions 212 
Version 5 and Version 6 library equivalences 360 
library base pointers 
See constlibbase compiler option 
library bases, initializing 
See system library bases, initializing 
library™ compiler option 84, 108 
.library files 
library bases 164-165 
library functions 

changes and enhancements xxxi, xxxii 
SAS/C Compiler behavior 335-339 
sc_]ib.guide help database 32 
library linker option 136 
library revision numbers 166 
fibre vision ™ compiler option 108-109 
librevision linker option 136 
fibs directory 7-8 
libversion™ compiler option 109 
libversion linker option 136 
fine number, in screen editor (se) 43 
Line Number option, Search pull-down menu 55 
fink compiler option 
finking C 4- + programs 188 
problems with resolving undefined symbols 211 
purpose and use 109 
required for running sample programs 17 
selecting from SAS/C Compiler Options Index screen 
startup modules 155 
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turned on by buildproject option 85 
using with sc command 132 
linkage specifications, C+ 4- 340 

See slink command 
linker options 133-139 
addsym 133 
batch 133 
bufsize 133 
chip xxx, 133, 194 

converting from Aztec C options 348-349 
define 133-134, 212, 352 
fancy 134 
fast 134, 194 
faster 134 
from 134 
fwidth 134 
height 134 
hwidth 135 
indent 135 
libfd 135 
libprefix 135-136 
library 136 
librevision 136 
libversion 136 
^ _ map 136 

maxhunk 136 
noalvs 136 
nodebug 137 
noicons 137 
nover 220 
onedata 137 
overlay 137 
overlymgr 137 
plain 137 
prelink 137 
pwidth 138 
quiet 138 
root 138 

smallcode 138, 194 
smalldata 138, 194 
stripdebug 138 
swidth 138 
to 138 
verbose 138 
verify 139 
width 139 
with 139 
xref 139 


linker symbols 

absolute symbols not used with residentable programs 
175 

at sign (@) preceding 134 
converting Version 5 to Version 6 352 
created for residentable programs 159 
defining with linkerdefine= compiler option 109 
extra underscores preceding 134 

LinkerDB 159, 175 

locating with findsym macro 75-76 
locating with findsymbol= compiler option 103-104, 
224 

name changes between versions xxiv, 211 
NEWDATAL 159 
RESBASE 159 
RESLEN 159 

resolving undefined symbols 211-213 
— LinkerDB symbol 159, 175 
linkerdefine= compiler option 109 
linkeroptions= compiler option 109-110, 132 
linkerwith= compiler option 110 
finking programs 
See programs, linking 
list compiler option 110, 224 
listfile= compiler option 110 
listheaders compiler option 110 
listincludes compiler option 110-111 
listmacros compiler option 111 
listnarrow compiler option 111 
listsystem compiler option 111 
lmkfile 85 

lntoslink conversion utility xxxii, 343 
load and stay resident programs 
See detachable programs 
See residentable programs 
load files 189 

Load Macros option, Project pull-down menu 59 
locale-specific behavior 339-340 
Log File option 4, 9 
logical device names 
assigning 10-11 
cxxinclude: 10-11 
ENV: 11 
include: 10 
fib: 11 

QUAD: no longer used 11 
ram: 11 
sc: 10 

long BackGroundIO external definition 157 

long priority external definition 157 

long stack external definition 157 



374 Index 


lseinst program xxv 


M 

macros 

See ARE XX macros 
See keystroke macros 
Main Menu key (F2) 54 
— main routine 

appending contents of — stdiov37 to stdiowin variable 

149-150 

converting incoming command to ANSI format 155 
problems with undefined symbols 213 
raising argument limits 155 
makedir command (AmigaDOS) 12 
makefile 85 

makeglobalsymboltable = compiler option 111 
See also globalsymboltable= compiler option 
malloc function 155, 339 
map compiler option 111 
map linker option 136 
mapfile= compiler option 111 
maphunk compiler option 112 
maplib compiler option 112 
mapoverlay compiler option 112 
mapsymbols compiler option 112 
mapxreference compiler option 112 
marked blocks 
See block operations 
math= compiler option 
coprocessor value 332 
Up value 113, 332 
ieee value 113 
purpose and use 112-113 
standard value 17, 18, 113, 211 
math libraries 

including incorrect library 212 
undefined symbol problems 211-213 
MAXARG symbol 155 
maxhunk linker option 136 
maximumerrors= compiler option 113 
maximumwamings™ compiler option 113 
mcc conversion utility xxxii, 343-344 
memory management 

clearing SAS/C compiler from memory 21, 27 
freeing memory 8 
low-memory management xxvii 
scspill.library 8 
memory-related options 
bssmemory = compiler option 95 


bufsize linker option 133 
chip linker option xxx, 133, 194 
codememory= compiler option 96 
datamemory= compiler option 100 
fast linker option 134, 194 
memorysize= compiler option 114-115 
memorysize= compiler option 114-115 
See also argumentsize = compiler option 
See also preprocessorbuffer = compiler option 
default values for argumentsize and preprocessorbuffer 
options 115 

purpose and use 114-115 
size specifications 1 14 

abbreviated menus 54 
block operations 57 
deleting text 56 
editing new files 59 
exiting screen editor 60 
inserting text 56 
keystroke macros 59 
managing windows 58 
moving around in files 55 
naming files 60 
saving files 60 

searching for and replacing strings 57 
selecting menu options 54 
undoing changes 60 
— MERGED hunk 189, 192 
message browser 
See scmsg (message browser) 

MESSAGE OPTIONS... gadget 18 
messages 

See error and warning messages 
mkmk utility 85 
min conversion utility xxxii, 344 
modified compiler option 85, 115 
Motorola processor 
portability considerations 203 
Move option, Block pull-down menu 57 
moving around in files 
See files 

msg # pragma statement 
See #pragma msg statement 
multiple base classes, C+ + 341 
multiple Tiles, editing 42 

multiplecharacterconstants compiler option 115-116 
multipleincludes compiler option 116 
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N 


O 


naming conventions 
ARE XX macros 72 
icons 27 
naming tiles 
See files 

narrow types in pre-ANSI function declarations 205-206 

national characters in variable names 185 

near BSS hunk 189 

near data 189 

near data hunk 189 

near keyword 172-173 

affecting only calling function 171 
compatibility with previous releases 173 
declaring data items 194 
declaring near data 189 
definition 170 

overriding data = auto compiler option 100 
purpose and use 172-173 
near value 

data= compiler option 99, 144, 158, 189 
nested comments 97, 185 
new operator, C++ 340 
NEWDATAL symbol 159 
^^newline character (\n) 

AREXX macros 72 
not generated automatically 336 
\n (newline character) 72 
No processing option 66 
noalvs linker option 136 
noautoreg compiler option 197 
NOBORDER keyword 150 
nocheckabort compiler option 220 
nodebug linker option 137 
NODRAG keyword 150 
NoErrorRexx gadget 18 
noicons linker option 137 
NoLink cycle gadget 18 
NoMath gadget 18 

NOMERGE hunk 193 

non-reentrant programs 193 
NOSIZE keyword 150 
-^nostackcheck compiler option 218 
nover linker option 220 
NTRYHUNK code hunk 145, 192 
NULL pointer constant 335 


.o filename extension 84 
objcct= compiler option 84, 116 
object files icons 28 
objectlibrary= compiler option 116 
objectname= compiler option 116-117 
oldpreprocessor compiler option 117-118 
onedata linker option 137 
onerror= compiler option 118 
online help 
See help system 

Open New Window option, Project pull-down menu 59 
Open Window option, Windows pull-down menu 43, 51, 
58, 59 
operands 

conversion types 196 
widest operand 195 
optimize compiler option 118, 175 
optimizeralias compiler option 118-119 
optimizercomplexity= compiler option 119 
optimizerdepth= compiler option 119 
optimizerglobal compiler option 119 
optimizerinline compiler option 119 
optimizerinlocal compiler option 119 
optimizerloop compiler option 120 
optimizerpeephole compiler option 120 
optimizerrecurdepth = compiler option 120 
optimizerschedule compiler option 120-121 
optimizersize compiler option 120 
optimizertime compiler option 120 
Options pull-down menu 
Auto-Indent Mode 67 
Backup File Mode 67-68 
Case Insensitive Search 45 
Case Sensitive Characters 68 
Column Display 67 
Configuration Window 61 
Convert Macro to Key 59 
Input Processing 66-67 
Prompt Before Undo 67 
purpose and use 62 
Searches Method 68 
Select Font... 66 
Tab Expansion Method 67 

oslibversion external long integer 165-166 

overlay linker option 137, 141 
overlay manager 
customizing 145 
definition 139 



overlay tree 

asterisks indicating depth 141 
definition 140 
examples 140, 142, 144 
terminating with pound sign {#) 141 
overlays 139-145 

compared with multiple shared libraries 139-140 
data=near compiler option 144 
definition 139 
functions in overlays 140 
linking 143 
listing filenames 141 
maximum number 141 
nodes in executable module 191 
overlay linker option 137, 141 
overlymgr linker option 137 
root node 140, 141 
smallcode compiler option 144 
smalldata compiler option 144 
specifying compiler options 145 
stringmerge compiler option 144-145 
with file 141 
with file, example 142-143 
— ovlymgr global symbol 145 
overlymgr linker option 137 
overwrite mode 44, 45, 56 


P 

%p conversion 337 
•p filename extension 84 
padding 201 

parameters= compiler option 121 
both value 121, 174, 219-220 
purpose and use 121 

register value xxviii, 121, 173-174, 219-220, 360 
stack value 121, 174 
path 

search path for #include statements 334 
specifying for AREXX macros 72 
path statement 

added to startup file by installation program 4 
adding to startup file 5, 213 
patterns 47 
peephole optimizer 

changes and enhancements xxv, xxix 
enabling with optimizerpeephole compiler option 120 
period (.) 

contained in name of startup module 155 
perror function messages 337-339 


PgDn (NUM-3) key 44 
PgUp (NUM-9) key 44 

phone numbers for SAS Institute Technical Support 33-34 
plain linker option 137 
plus sign (+) 

continuing lines of filenames for overlays 141 
separating filenames for overlays 141 
separating filenames for sc command 84 
pointers 

causing computer crashes 218 
default length 195 
SAS/C Compiler behavior 333 
specifying keywords 171 
portable code, writing 199-207 
See also implementation-defined behavior 
compiling with strict or ansi options 199-200 
data and type sizes 201 

defining — STRICT — ANSI preprocessor symbol 200 
guidelines for avoiding problems 200-201 
incomplete structure tags 206-207 
narrow types in pre-ANSI function declarations 205-206 
structure size and padding 201-202 
writing structures to disk file 202-204 
pound sign (#) 

terminating overlay tree 141 
pponly compiler option 188, 223, 224 
#pragma amicall statement xxxii, 178 
# pragma flibcall statement 178 
#pragma libcall statement 178, 334 
fpragma msg statement 178-179 
error keyword 178 
example 179 
ignore keyword 178 
pop keyword 179 
push keyword 178 

suppressing error and warning messages 223 
warn keyword 178 
fpragma regcall statement xxxii, 178 
fpragma statements 177-179 
types of fpragma statements 177-178 
using in residentable programs 158 
fpragma syscall statement 178, 334 
fpragma tagcall statement xxvii, 178, 334 
precision = compiler option 122 
prelink linker option 137 
preprocessing 

C+ + programs 188, 189 

comma (,) operator 184 

incorrect use resulting in error messages 223 

oldpreprocessor compiler option 117-118 

sizeof operator 184 
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preprocessor directives 
comma operator 184 
SAS/C Compiler behavior 334 
sizeof operator 184 
preprocessor symbols 
defined by compiler 130-131 
defined by compiler options 131-132 
defined by define= option 101 

GENPROTO 105 

SHORTINT 123 

STRICT ANSI 94, 200 

preprocessorbuffer = compiler option 122 
preprocessoronly compiler option 122 
Pretend to Install and Log File options 4, 9 
primary node 191 

Print option. Block pull-down menu 57 

priority external definition 157 

problemsolving 211-221 
See also help system 
See also SAS Institute Technical Support 
asctime function 218-219 
Codeprobe problems 215 
compilation errors 213-215 
crashing the machine 218 
eliminating informational messages 220 
formatted print functions 215-216 
getchar problems 216 
incorrect results from function calls 217 
resident programs or libraries 219 
resolving undefined symbols 211-213 
standard I/O window 219 
turning off control-C checking 220-221 
writing replacement functions 219-220 
proceed command, debugger 
equivalent to Return key 22 
process restrictions using startup modules 156 
processor-specific code 
See CPU= compiler option 
profile compiler option xxx, 122 
programname= compiler option 122 
programs, compiling 83-87, 189-191 
See also compiler options 
See also compiler options, setting 
See also sc command 
Build icon 19-20 
hunks 189-191 

numbered compiler messages 227-282 
portability considerations 199-200 
rebuilding programs 20 
recompiling and linking 20 
sc command 25-26, 83-85 


screen editor 52 
Shell method 23-26 
smake utility 19, 85 
solving problems 213-215 
standard I/O window 20-21 
unnumbered compiler messages 225-226 
Workbench method 17-20, 85 
programs, debugging 
See CodeProbe Source Level Debugger 
programs, linking 
See also linker options 
See also sc command 
See also slink command 
Build icon (Workbench) method 19-20 
linking with startup modules 155-159 
production of executable module 191 
smake utility 20, 85 
programs, running 
example programs 20-21, 26 
heap area 192 
stack area 192 
Workbench method 147-151 
programs, writing 
See portable code, writing 
See source files, creating 
Project pull-down menu 
Close Window 51, 58 
Display Names 60 
Exit SE 51, 60 
File 48 
Insert File 56 
Load Macros 59 
Open New Window 59 
purpose and use 62 
Rename 60 
Save & Close 51, 60 
Save & Continue 51, 60 
Save & Reopen 51, 59, 60 
Save Macros 59 
Undo Last Change 60 
projects 
definition 6, 8 
setting up 14-15 

PROLOG library function 122 

Prompt Before Undo option, Options pull-down m 
prototype generation 104-105 
pubscreen= compiler option 123 
putenv function 339 
pwidth linker option 138 
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Q 

QUAD: logical device 11, 351 
qualifier keys 63, 64 
qualifiers 

SAS/C Compiler behavior 334 
question mark (?) 

getting help for sc command 85 
quiet linker option 138 
quit (q) command, debugger 22, 27 

enclosing finclude statements 334 
enclosing strings 334 

unnecessary for regular expressions including spaces 47 


R 

ram: logical device 11 

raw code for key definitions 64 

rawcon function 216 

Read option, Block pull-down menu 48, 57 

read.me file 5, 9, 211 

realloc function 339 

reentrant and non-reentrant programs 193 
— regargs keyword 173-174 
affecting caller and callee 171 
definition 170 
purpose and use 173-174 

using with user-written replacement functions 121, 
219-220 

register keyword 197, 333 
register storage class 197 
registerized parameters xxiv, 360 
registers 

SAS/C Compiler behavior 333 
registration required for SAS Technical Support 
registration card 35 
registration number 3, 36-37 
regular expressions 
definition 45 
entering in searches 47 
Use Regular Expressions option 68 
relaxed ref-def external data xxvi, 185-186 
relocation records 189 
Rename option. Project pull-down menu 60 
Replace command 
See Search and Replace command 
RESBASE symbol 159 
resetoptions compiler option 86, 123, 214 
resident command (AmigaDOS) 158 


resident libraries, creating 219 
resident program 
definition 158 

residentable programs 158-159 
See also detachable programs 
creating 158-159 

cres.o startup module 158, 158-159 
debugging with catchres.o startup module 159 
inability to reference absolute symbols 175 
requirements 158-159 
solving problems 219 
symbols created by slink 159 
RESLEN symbol 159 
Return key 

equivalent to proceed command 22 
root linker option 138 

contents 141, 191 
definition 140 
running programs 
See programs, running 


s 

.s filename extension 84 
s:user-startup file 
See startup file 
SAS/C compiler 187-197 
See also compiler options 
See also programs, compiling 
addressing data 193-194 
changing hunk names 192-193 
clearing from memory 21, 27 
compiling C programs 189-191 
data types and sizes 194-197 
hunks 189-191 
linking programs 191 
running programs 191-192 
storing data 197 

translating C++ programs 187-189 
SAS/C Compiler Options Index screen, illustration 18 
SAS/C Development System, installing 
See installation of SAS/C Development System 
SAS/C extensions to C and C+ + languages 169-186 
C+ + style comments 184 
comma (,) operator 184 
dollar signs in variable names 185 
enumerated types 183-184 
equivalent structures 181-183 
implicit structure references 180-181 
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managing stack space 176-177 

national characters in variable names 185 

nested comments 185 

#pragma statements 177-179 

relaxed ref-def external data xxvi, 185-186 

sizeof operator 1 84 

special keywords 170-175 

unnamed unions xxvii, 179-180 

zero-length arrays 183 

aligned keyword 171-172 

asm keyword 173 

chip keyword 172-173 

far keyword 172-173 

inline keyword 175 

interrupt keyword 173 

near keyword 172-173 

regargs keyword 173-174 

saveds keyword 174-175 

stackext keyword 176-177 

stdargs keyword 173-174 

SAS/C Message Browser Window, illustration 19 
See also scmsg (message browser) 

SAS/C tools, using 
See Shell 

See Workbench screen 
SAS Institute Technical Support 32-38 
See also problem solving 
BIX method of contacting 34 
EMITS (Electronic Mail Interface to Technical Support) 
facility xxiii, 34-36 
information requirements 36-37 
Internet or Usenet methods of contacting 34-36 
phone, mail, or fax methods of contacting 33-34 
problem description 37 
problem description, example 38 
registration information requirements 35, 36-37 
when to call 32-33 
sascopts file, converting 351-352 
Save & Close option, Project pull-down menu 51, 60 
Save 8c Continue option, Project pull-down menu 51, 60 
Save 8c Reopen option, Project pull-down menu 51, 59, 60 
Save gadget 18 

Save Macros option, Project pull-down menu 59 
saveds compiler option 123 

compared with saveds keyword 174 

not used with cres.o startup module 158 
purpose and use 123 

saveds keyword 174-175 

applications without startup modules 160 
compared with saveds compiler option 123, 174 
definition 170 


effect on definitions of functions 171 
equivalent to geta4 function 175 
not used with cres.o startup module 158 
not used with residentable programs 175 
purpose and use 123, 174-175 
saving files 
See files 

sc command 83-85 
See also compiler options 
compared with slink command 132 
compiling and linking programs 25-26 
filename extensions 84 
icons created by 28 

including options on command line 25, 86 

link compiler option 132 

mcc as Aztec C-compatible driver 343 

options for specifying filename extensions 84 

replacement for lc command xxiii 

sc.guide help database 32 

specifying multiple filenames 84 

specifying startup modules 155 

startup option 155 

syntax 83 

sc.guide help database 32 
sc_lib.guide help database 32 
sc_util.guide help database 31 
sc: directory 

locating source code in some other directory 8 
location of read.me file 5 
sc: logical device 10 
sc:examples/cback directory 30 
sc:help directory 31-32 
sc:icons drawer 27 
sccxx.library 7 
scdebug.library 7 
scgo.library 7 
scgst.library 7-8 
schelp program 30 
schi.library 8 
scmsg (message browser) 
correcting errors in source file 19-20, 25-26 
Edit window, illustration 20 
errorrexx compiler option required to run 17 
overriding public screen options 123 
SAS/C Message Browser Window, illustration 19 
scmsg.guide help database 31 
scmsg.guide help database 31 
scoptions file 

converting sascopts file 351-352 
entering on scopts command line 24 
overriding settings 86 
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scoptions file ( continued ) 

redirecting output from cctosc conversion utility 343 
saving compiler option settings 18, 24 
saving options as project options 86 
solving problem 214 
SCoptions icon 
purpose 6, 15 
running scopts utility 17 
scopts utility 
gadgets for selecting 17 
including options on command line 24 
running 17 

running from screen editor 52 
SAS/C Compiler Options Index screen, illustration 18 
saving compiler option settings 18 
selecting options from screen 24 
setting compiler options 17-18, 24-25 
starting with SCoptions icon 15 
scpeep.library 7 
screen editor (se) 41-52 
See also AREXX interface 
See also se command 
See also SE Configuration window 
block operations 47-48, 57 
changing colors 58 
commands for controlling 53-60 
compiling programs 52 
creating source files 15-17, 23 
default icon def_se 27 
default keystroke definitions 41 
default window size 45 
deleting text 45, 56 
editing new files 59 
editing text 44-50 
entering control characters 50 
entering text 44-50 
exiting 50-51, 60 
getting help 52, 54 
help screen, illustration 30 
icons created by 28 
insert mode 44, 45, 56 
inserting text 56 
keystroke macros 49-50, 59 
managing windows 51-52, 58 
maximum line length 45 
maximum number of open files 43 
moving around in files 44, 55 
naming files 60 
overwrite mode 44, 45, 56 
replacing character strings 46-47, 57 
restoring last line of deleted text 45 


saving files 50-51, 60 
se.guide help database 31 
searching for character strings 45-46, 57 
selecting menu options 54 
split-screen mode 52 
starting 14, 42-43 
status line 43-44 
substituting other editors 14 
switching between windows 42, 52 
undoing changes 45, 48, 60 
window display size 43 
screen editor (se), customizing 
See SE Configuration Window 
screen editor (se), starting 42-43 
Edit icon 6, 14, 42 
se command 42 

specifying more than one filename 42 
SCREEN keyword 150 
scsetup utility 
icons created by 28 
setting up new projects 14, 15 
scspill.library 8 
scl. library 7 
sc2.1ibrary 7 
sc5 command 

converting old code to Version 6 xxiii, 351 
se command 

See also screen editor (se) 
creating files 23 
-d option 42 
syntax 42 
-v option 42 

SE Configuration Window 61-69 
Asm modes 66-67 
assigning keys to AREXX macros 72 
Auto-Indent Mode option 67 
Autowrap option 67 
Backup File Mode option 67-68 
Case Sensitive Characters option 68 
closing without saving 69 
Column Display option 43, 67 
displaying 61-62 
illustration 62 
Input processing option 66-67 
key definitions, displaying 63-64 
key definitions, setting 64-65 
Keys 1-4 pull-down menu 62 
No processing option 66 
Options pull-down menu 62 
Project pull-down menu 62 
Prompt Before Undo option 67 
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reusing saved settings 69 
Save As option 68 
Save option 68 
saving new settings 68-69 
Searches Method option 45, 68 
Tab Expansion Method option 67 
tab stops, setting 65 
Use option 68 
se.dat file 42 
se.guide help database 31 
Search and Replace command 
entering regular expressions 47 
prompted replacements 46 
replacing character strings 46-47 
Search command 
backward searching 46 
case sensitivity 45 
entering regular expressions 47 
forward searching 46 
regular expressions 45 
searching for character strings 45-46 
Search pull-down menu 
Line Number 55 
Search Again 57 
Search and Replace 57 
String Search 57 
Searches Method option 
Options pull-down menu 68 
String Matching 45, 68 
Use Regular Expressions 68 
searching for character strings 
See character strings 
sekeymap.library 8 

Select Font... option. Options pull-down menu 66 
semicolon (;) 

Asm mode 66 
setbuf function 337 
setenv command 1 1 
setvbuf function 337 
shared libraries 

compared with overlays 139-140 
creating 159 

SAS/C compiler support xxxi 
Shell 

compiling, linking, and running programs 23-26 
creating source file with se 23 
debugging programs 26-27 
environment for argv and argc 147-148 
modifying startup file for programs creating new shells 
3, 213 

printing messages in the Shell 158 


running programs linked with startup module 156 
using SAS/C tools 23-28 
Shift keys 
equivalence 64 
independent operation 64 
short integers 

problems with casting results 196-197 

-SHORTINT preprocessor symbol 123 

shortintegers compiler option 123, 195, 196 
portability considerations 201 
SIGABRT function 335 
SIGFPE function 335 
SIGILL function 335 
SIGILL signal 336 
SIGINT function 335 
S1GINT signal 336 
signal function 335, 336 
signed data types 
See data types and sizes 
signed keyword 194, 201 
SIGSEGV function 335 
SIGTERM function 335 
SIMPLE keyword 150 
sizeof operator 

portability of structures 202 
preprocessor directives 184 
slash (/) 

comment start sequence (/*) 185 
contained in name of startup module 155 

ending replacement string for stdiowin 149 

slashes (//) defining comment blocks 185 
slink command 
See also linker options 
See also programs, linking 
compared with sc command 132 
default linker icon 27 
evaluation of with files 143 
icons created by 28 
linker messages 320-326 
linking programs 20, 25 
linking startup modules 156 
min as Aztec C-compatible driver 344 
symbols created for residentable programs 159 
syntax 132, 156 
smake utility 

compiling programs 19, 85 
definition 14 
linking programs 20, 85 
smakefilc 85 

smallcodc compiler option 123, 144 
smallcodc linker option 138, 194 
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smalldata compiler option 124, 144 
smalldata linker option 138, 194 
SMART keyword 150 
smfind utility 
purpose 14, xxxi 
starting with Find icon 14 
snapshot flies 
creating 156, 159 

hard drive corruption (caution) 156, 159 
solving problems 
See problem solving 
source code 

storing in sc: directory not recommended 8 
source directory 7 
source flies, creating 
C program, example 15 
C+ + program, example 16 
correcting errors 19-20, 25-26 
naming, saving, and closing editor window 16 
screen editor method 15-17, 23 
Shell method 23-28 
Workbench method 15-17 

Source window, CodeProbe Source Level Debugger 21-22 
sourceis = compiler option 124 

Asm mode 66 

separating AREXX commands 71 
special keywords 
See keywords 
sprof utility xxx 

alignment problems 172 
changes and enhancements xxvi 
definition 176 

effect of autoinitialization and autotermination functions 
163 

managing stack space 176-177 
purpose and use 192 
running out of stack space 177 
stack command (AmigaDOS) 192 
— stack external definition 157 
— stack external long integer 176, 177, 192 
stack overflow routine (_CXOVF) 176 
stackcheck compiler option 124 
compiling functions with stackcheck and stackextend 177 
disabled in autoinitialization and autotermination 
functions 163 

not used with shared libraries 176 

purpose and use 124 

solving machine crash problems 218 


— stackext keyword 176-177 
definition 170 

effect on definitions of functions 171 
implementation-defined behavior 333 
managing stack space 176-177 
stackextend compiler option 124 
disabled in autoinitialization and autotermination 
functions 163 

implementation-defined behavior 333 
managing stack space 176-177 
purpose and use 124 
standard I/O window 20-21 
behavior under AmigaDOS 1.3 21 
changing window attributes 149-151 
closing with Close gadget 21 
declaring — stdiov37 external variable 150 
declaring — stdiowin external variable 149, 150 
eliminating 219 
keywords for controlling 150 
standard programs, creating 156 
standardio compiler option 124 
starter_project directory 6, 14 
startups compiler option 125, 155 
startup file 

including execute command 5 
lines added by installation program 4 
location of lines required for SAS/C Development 
System 5 
modifying 5-6 
solving problems 213 

storing environment variable information 11-12 
startup modules 154-160 
See also autoinitialization function 
See also autotermination function 
assembler source code location 154 
changing argument limits 155 
detachable programs 157-158 
linking with startup modules 155-159 
list of modules 154 

modifying main 155 

purpose and use 154-155 
residentable programs 158-159 
shared libraries 159 
Shell process restrictions 156 
standard programs 1 56 
tasks performed by all modules 154-155 
writing applications without startup modules 160 
state of messages 1 78 
statements 

SAS/C Compiler behavior 334 
static storage class 197 
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status line of screen editor 43-44 

_STD as designation for autotermination function 161 

stdargs keyword 121, 173-174 

affecting caller and callee 171 

definition 170 

purpose and use 173-174 

solving compatibility problems between versions 213 
using with parameters™ register option xxviii 
using with parameters™ stack option 121 

stdiov37 external variable 149-150 

stdiowin external variable 

declaring 149-150 
endings for replacement string 149 
_ STI as designation for autoinitialization function 161 
— STKNEED external long integer 176, 177 
storage classes 197 
automatic 197 
externa] 197 
formal 197 
register 197 
static 197 

strerror function 339 

STRICT ANSI preprocessor symbol 94, 200 

strict compiler option 125 
C+ + style comments not allowed 184 
enabling suppressed messages 201, 224, 327 
portability considerations 199-200 
^ purpose and use 125 

strict reference-definition model of external data 185-186 
String Matching option, Searches Method 45 
String Search option, Search pull-down menu 57 
stringconst compiler option 125 
stringmerge compiler option 125-126 
equivalent to -cs in Version 5 xxvi 
purpose and use 125-126 
using overlays 144-145 
stringsection™ compiler option 126-127 
advantages 127 
code value 127 
declaring data items 194 
default value 126-127 
effect on static objects 197 
far value 127 
near value 127 
purpose and use xxx, 126-127 
stripdebug compiler option 126 
stripdebug linker option 138 
structureequivalence compiler option 127, 181 
structures 

determining size and padding 201-202 
equivalent structures 181-183 


implicit structure references xxvii, 180-181 

incomplete structure tags 206-207 

IntuiMessage 182 

IOExtSer 182 

IoRequest 182 

Message 182 

portability guidelines 203-204 
SAS/C Compiler behavior 333 
WBStartup 148, 330 
writing to disk file 202-204 
zero-length array as last element of 183 

stub library function 133 

suppressed messages, enabling 327-328 
swidth linker option 138 
switch options 86 

Switch Windows option, Windows pull-down menu 43, 58 
switching between windows 
See windows 
symbols 

See linker symbols 
SysBase 

required for programs without startup modules 160 
System Default font xxx 
system function 339 
system header files 
See header files 
system library base pointers 
See constlibbase compiler option 
system library bases, initializing 163-167 
automatically initialized library bases xxvii, 164-165 
defining library bases in your code 165 
examples 164, 165 
failure of libraries to open 166-167 
library bases for .library files 164-165 
library revision numbers 166 


T 

Tab Expansion Method option. Options pull-down menu 67 
tabs 

Asm mode 66 

converting to spaces with deletetabs macro 75 
setting tab stops 65 
tb utility 156, 159 
technical support 

See SAS Institute Technical Support 
telephone numbers for SAS Institute Technical Support 
33-34 
text, editing 
See screen editor (se) 
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text hunk 189 
time and date 

locale-specific behavior 339-340 
— TIME preprocessor macro 334 
time zone, default 339 
time zone environment variable 218-219 
— tinymain routine xxxi 
title for standard I/O window 149 
to= compiler option 128 
to linker option 138 

Toggle Display Size option, Windows pull-down menu 43, 
52, 58 

tolower.se 76 
toupper.se 76 
traceback information 
See snapshot files 
translating C++ programs 
See C+ + programs, translating 
translation (diagnostics) 

SAS/C Compiler behavior 330 
trigraph compiler option 128 
troubleshooting 
See problem solving 
truncation of files after write 336 
type specifiers, C+ + 340 


u 

-u assembler option 145 
udata hunk 190 

undefined symbols, resolving 211-213 
underscore (_) 

adding extra underscores 134 
default prefix for functions 135 
preceding linker symbols 135 
underscore compiler option 128 
undo command 

Prompt Before Undo option 67 
undoing changes 48 

Undo Last Change option. Project pull-down menu 60 

unindent.se 76 

unions 

SAS/C Compiler behavior 333 
unnamed unions xxvii, 179-180 
unschar compiler option 334 
unsigned data types 
See data types and sizes 
unsigned keyword 194 
unsignedchar compiler option 128, 194 


upgrading from previous versions 
See Version 5, converting to Version 6 
Use Regular Expressions, Searches Method option 68 
Usenet for contacting SAS Institute Technical Support 
34-36 

utilitylibrary compiler option 128-130 

V 

-v option, se command 42 
variables 

displaying value in debugger 22 
dollar signs ($) in variable names 185 
national characters in variable names 102, 185 
verbose compiler option 129, 190, 214 
verbose linker option 138 
verify linker option 139 
version compiler option 129 
version number of screen editor, displaying 42 
Version 6 

See also Version 5, converting to Version 6 
changes and enhancements xxiii-xxviii 
corresponding executables in Version 5 xxiv 
Version 5, converting to Version 6 351-360 
compilation errors 213-215 
converting compiler options 352-359 
installing Version 6 351-352 
recompiling code 351 
sascopts file conversion 351-352 
specifying Version 6 libraries 360 
unresolved symbols 352 

Version 6.50 changes and enhancements xxix-xxxii 


w 

WAIT keyword 150 
warn = compiler option 129 
enabling suppressed messages 201, 224, 327 
purpose and use 129 
warnings, enabling 
See also warn — compiler option 
incomplete structure tags 207 
narrow types 206 
options for enabling 224, 327-328 
warnings and error messages 
See error and warning messages 
warnvoidretum compiler option 129 
WBStartup structure 148, 330 
widest operand 195 
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width linker option 139 
WINDOW keyword 150 
windows 

default window size in screen editor 45 
displaying two files 43 
managing in screen editor 51-52, 58 
' switching between windows in screen editor 42, 43 
text window size in screen editor 43 
window number status 44 
Windows pull-down menu 
Create New CL1 58 
Interlace Toggle 58 
Open Window 43, 51, 58, 59 
Switch Windows 43, 58 
Toggle Display Size 43, 52, 58 
with= compiler option 130 


with files 

asterisk (*) indicating depth of overlay tree 141 
examples 142-143 
format 141 

plus sign ( + ) separating filenames 141 
pound sign (#) terminating overlay tree 141 
with linker option 139 
Workbench screen 14-22, 147-151 
compiling programs 17-20, 85 
, creating source file with se 15-17 
debugging programs 21-22 
environment for argv and argc 148 
Unking programs 19-20 
program structure, example 148 
running programs 20-21, 147-151 
setting up projects 14-15 
standard I/O window management 149-151 
using SAS/C tools 14-22 
write function (AmigaDOS) 157 
Write option, Block pull-down menu 57 
writing programs 
See portable code, writing 
See source files, creating 


X 


xreferencesystem compiler option 130 


z 


zero-length arrays 183 


Special Characters 

1 1 (braces) 

See braces (| |) 

, (comma) 

See comma (,) 

/ (slash) 

See slash (/) 

. (period) 

See period (.) 

< > (angle brackets) 

See angle brackets (< >) 

+ (plus sign) 

See plus sign ( + ) 

$ (dollar sign) 

See dollar sign ($) 

‘ (asterisk) 

See asterisk (*) 

* procname external definition 157 

; (semicolon) 

See semicolon (;) 

—(underscore) 

See underscore (_) 

> (greater than sign) 

See greater than sign (>) 

? (question mark) 

See question mark (?) 

: (colon) 

See colon (:) 

# (pound sign) 

See pound sign (#) 

@ (at sign) 

See at sign (@) 


XCEXIT function 166-167 

— XDEFS in hunks 1 89 
r ^ XREF compUer option 130 
xref linker option 139 
xreference compiler option 130 
xreferenceheaders compiler option 130 


16-bit address 

advantages and disadvantages 193 
relative to program counter 193 
relative to register A4 193 
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16-bit references 

generated for near data section 172 
specifying with code= compiler option 96 


3 

32-bit address 

advantages and disadvantages 193 
32-bit references 
chip data 193-194 

generated by absfuncpointer compiler option 
generated for far data section 172 
specifying with code= compiler option 96 


6 

68040/68882 Instruction Scheduler xxix 



Your Turn 

If you have comments or suggestions about the SAS/C Development 
System User’s Guide, Volume 1: Introduction, Compiler, Editor, 
Version 6.50 or the SAS/C Development System, please send them to 
us on a photocopy of this page. 

Please return the photocopy to the Publications Division (for 
comments about this book) or the Technical Support Division (for 
suggestions about the SAS/C Development System) at SAS Institute 
Inc., SAS Campus Drive, Cary, NC 27513. 












